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Redis 命令 参考 


Key ( 键 ) 


DEL 
DUMP 
EXISTS 
EXPIRE 
EXPIREAT 
KEYS 
MIGRATE 
MOVE 
OBJECT 
PERSIST 
PEXPIRE 


PEXPIREAT 


PTTL 


RANDOMKEY 


RENAME 


RENAMENX 


RESTORE 


H $k 


键 空间 通知 (keyspace notification) 
事务 (transaction) 

发 布 与 订阅 (pub/sub) 

复制 (Replication) 

通信 协议 (protocol) 

持久 化 (persistence) 

Sentinel 

集群 教程 
Redis 集群 规范 
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SORT 
TYPE 
SCAN 


String (FFE) 


APPEND 
BITCOUNT 
BITOP 
DECR 
DECRBY 
GET 
GETBIT 
GETRANGE 
GETSET 
INCR 
INCRBY 
INCRBYFLOAT 
MGET 
MSET 
MSETNX 
PSETEX 
SET 
SETBIT 
SETEX 
SETNX 
SETRANGE 
STRLEN 


Hash ( 哈 希 表 ) 


HDEL 

HEXISTS 

HGET 
HGETALL 
HINCRBY 
HINCRBYFLOAT 
HKEYS 
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List 


Set 





HLEN 
HMGET 
HMSET 
HSET 
HSETNX 
HVALS 
HSCAN 
(列表 ) 
BLPOP 
BRPOP 
BRPOPLPUSH 
LINDEX 
LINSERT 
LLEN 

LPOP 
LPUSH 
LRANGE 
LREM 

ESET 

LTRIM 
RPOP 
RPOPLPUSH 
RPUSH 
RPUSHX 
(集合 ) 

SADD 
SCARD 
SDIFF 
SDIFFSTORE 
SINTER 
SINTER 
SINTERSTORE 
SISMEMBER 
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SMEMBERS 
SMOVE 

SPOP 
SRANDMEMBER 
SREM 

SUNION 
SUNIONSTORE 
SSCAN 


SortedSet (有 序 集合 ) 


ZADD 
ZCARD 
ZCOUNT 
ZINCRBY 
ZRANGE 


ZRANGEBYSCORE 


ZRANK 
ZREM 


ZREMRANGEBYRANK 
ZREMRANGEBYSCORE 


ZREVRANGE 


ZREVRANGEBYSCORE 


ZREVRANK 
ZSCORE 
ZUNIONSTORE 
ZINTERSTORE 
ZSCAN 


Pub/Sub (发 布 /订阅 ) 


PSUBSCRIBE 
PUBLISH 
PUBSUB 
PUNSUBSCRIBE 
SUBSCRIBE 
UNSUBSCRIBE 


Transaction (事务 ) 
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DISCARD 
EXEC 
MULTI 
UNWATCH 
WATCH 


Script (脚本 ) 


EVAL 

EVALSHA 
SCRIPT EXISTS 
SCRIPT FLUSH 
SCRIPT KILL 
SCRIPT LOAD 


Connection (连接 ) 


AUTH 
ECHO 
PING 
QUIT 
SELECT 


Server (服务 器 ) 
BGREWRITEAOF 


BGSAVE 


CLIENT GETNAME 


CLIENT KILL 
CLIENT LIST 


CLIENT SETNAME 


CONFIG GET 


CONFIG RESETSTAT 
CONFIG REWRITE 


CONFIG SET 
DBSIZE 
DEBUG OBJECT 


DEBUG SEGFAULT 


FLUSHALL 
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天 于 





FLUSHDB 
INFO 
LASTSAVE 
MONITOR 
PSYNC 
SAVE 
SHUTDOWN 
SLAVEOF 
SLOWLOG 
SYNC 
TIME 
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译 者 : 黄 健 宏 (huangz) 
来 源 : Redis 命令 参考 
本 文档 是 Redis Command Reference 和 Redis Documentation 的 中 文 翻译 版 ， 阅读 这 个 文 


档 可 以 帮助 你 了 解 Redis 命令 的 具体 使 用 方法 ， 并 学 会 如 何 使 用 Redis 的 事务 、 持 久 化 、 复 
制 、Sentinel、 和 集群 等 功能 。 


由 本 文档 译 者 制作 的 《Redis 命 令 速 查 表 》 正 在 销售 中 ! 该 表 能 够 与 本 文档 相辅相成 ， 
帮助 读者 更 好 地 了 解 和 查阅 Redis 命令 ， 有 兴趣 的 读者 可 以 通过 访问 以 下 链接 来 了 解 更 
多 信息 : https://selfstore.io/products/538 
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键 空间 通知 (keyspace notification) ) 


Note 
本 文档 翻译 自 : http://redis.io/topics/notifications 。 
Warning 


键 空间 通知 功能 目前 仍 在 开发 中 ， 这 个 文档 所 描述 的 内 容 ， 以 及 功能 的 具体 实现 ， 可 能 会 在 
未 来 数 周 内 改变 ， 敬 请 知悉 。 


功能 览 

空间 通知 使 得 客户 端 可 以 通过 订阅 频道 或 模式 ， 来 接收 那些 以 某 种 方式 改动 了 Redis 数据 
ددم‎ 
以 下 是 一 些 键 空间 通知 发 送 的 事件 的 例子 


٠ 所 有 修改 键 的 命令 。 
٠ 所 有 接收 到 LPUSH 命令 的 键 。 
٠ 9 号 数据 库 中 所 有 已 过 期 的 键 。 


事件 通过 Redis 的 订阅 与 发 布 功 能 (pub/sub) 来 进行 分 发 ， 因此 所 有 支持 订阅 与 发 布 功能 
的 客户 端 都 可 以 在 无 须 做 任何 修改 的 情况 下 ， 直接 使 用 键 空间 通知 功能 。 


因为 Redis 目前 的 订阅 与 发 布 功能 采取 的 是 发 送 即 忘 (fire and forget) 策略 ， 所 以 如 果 你 的 
程序 需要 可 靠 事件 通知 (reliable notification of events) , 那么 目前 的 键 空 间 通知 可 能 并 不 适 
合 你 : 当 订 阅 事件 的 客户 端 断 线 时 ， 它 会 丢失 所 有 在 断 线 期 间 分 发 给 它 的 事件 。 


未 来 将 会 支持 更 可 靠 的 事件 分 发 ， 这 种 支持 可 能 会 通过 让 订阅 与 发 布 功能 本 身 变 得 更 可 靠 来 
实现 ， 也 可 能 会 在 Lua 脚本 中 对 消息 (message) 的 订阅 与 发 布 进行 监听 ， 从 而 实现 类 似 将 
事件 推 入 到 列表 这 样 的 操作 。 


事件 的 类 型 


对 于 每 个 修改 数据 库 的 操作 ， 键 空间 通知 都 会 发 送 两 种 不 同类 型 的 事件 。 


比如 说 ， 对 o 号 数据 库 的 键 mykey 执行 DEL MD, 系统 将 分 发 两 条 消息 ， 相当 于 执行 
以 下 两 个 PUBLISH 命令 : 


PUBLISH __keyspace@0__:mykey del 
PUBLISH __keyevent@0__:del mykey 


订阅 第 一 个 频道 __keyspace@o__:mykey 可 以 接收 o 号 数据 库 中 所 有 修改 键 mykey HS 
件 ， 而 订阅 第 二 个 频道 _keyevent@o_:del 则 可 以 接收 و‎ 号 数据 库 中 所 有 执行 del MA 
的 键 。 


以 keyspace 为 前 级 的 频道 被 称 为 键 空间 通知 (key-space notification) ， 而 以 keyevent 
为 前 级 的 频道 则 被 称 为 键 事件 通知 (key-event notification) 。 


当 del mykey 命令 执行 时 : 


。 键 空间 频道 的 订阅 者 将 接收 到 被 执行 的 事件 的 名 字 ， 在 这 个 例子 中 ， 就 是 del o 
٠ 键 事件 频道 的 订阅 者 将 接收 到 被 执行 事件 的 键 的 名 字 ， 在 这 个 例子 中 ， 就 是 mykey o 


Ac is 


因为 开启 键 空间 通知 功能 需要 消耗 一 些 CPU, 所 以 在 默认 配置 下 ， 该 功能 处 于 关闭 状态 。 


可 以 通过 修改 redis.conf 文件 ， 或 者 直接 使 用 CONFIG SET 命令 来 开启 或 关闭 键 空间 通知 
功能 : 

e 当 notify-keyspace-events 选项 的 参数 为 空 字符 串 时 ， 功 能 关闭 。 

。 另 一 方面 ， 当 参数 不 是 空 字 符 串 时 ， 功 能 开 和 所。 


notify-keyspace-events 的 参数 可 以 是 以 下 字符 的 任意 组 合 ， 它 指定 了 服务 器 该 发 送 哪些 类 
型 的 通知 : 


字符 发 送 的 通知 

K 键 空间 通知 ， 所 有 通知 以 keyspace@&lt;db&gt; ”为 前 组 
E 键 事 件 通 知 ， 所 有 通知 以 _ keyevent@alt;dbagt; 4 BUA 
g DEL 、 EXPIRE 、 RENAME 等 类 型 无 关 的 通用 命 合 的 通知 
$ 字符 串 命 邻 的 通知 

1 列表 命令 的 通知 

s 集合 命令 的 通知 

h 哈 希 命令 的 通知 

z 有 序 集合 命令 的 通知 

x 过 期 事件 : 每 当 有 过 期 键 被 删除 时 发 送 

e 驱逐 (evict) 事 件 : 每 当 有 和 键 因 为 maxmemory 政策 而 被 删除 时 发 送 
A 参数 g$lshzxe 的 别名 


输入 的 参数 中 至 少 要 有 一 个 k 或 者 E , 否则 的 话 ， 不 管 其 余 的 参数 是 什么 ， 都 不 会 有 任 
何 通知 被 分 发 。 


举 个 例子 ， 如 果 只 想 订 阅 键 空间 中 和 列表 相关 的 通知 ， 那么 参数 就 应 该 设 为 kl ， 诸如 此 


NO 


将 参数 设 为 字符 串 "ake" 表示 发 送 所 有 类 型 的 通知 。 


命令 产生 的 通知 


以 下 列表 记录 了 不 同 命令 所 产生 的 不 同 通知 : 


DEL 命令 为 每 个 被 删除 的 键 产 生 一 个 del 通知 。 

RENAME 产生 两 个 通知 : 为 来 源 键 (source key) 产生 一 个 rename_from 通知 ， 并 为 目 
标 键 (destination key) 产生 一 个 rename_to 通知 。 

EXPIRE 和 EXPIREAT 在 键 被 正确 设置 过 期 时 间 时 产生 一 个 expire 通知 。 当 
EXPIREAT 设置 的 时 间 已 经 过 期 ， 或 者 EXPIRE 传 入 的 时 间 为 负数 值 时 ， 键 被 删除 ， 并 
产生 一 个 del 通知 。 

SORT 在 命令 带 有 store 参数 时 产生 一 个 sortstore BH, WR store 指示 的 用 于 保 
存 排 序 结果 的 键 已 经 存在 ， 那 么 程序 还 会 发 送 一 个 del 事件 。 

SET 以 及 它 的 所 有 变种 (SETEX 、 SETNX 和 GETSET) 都 产生 set 通知 。 其 中 
SETEX 还 会 产生 expire 通知 。 

MSET 为 每 个 键 产生 一 个 set 通知 。 

SETRANGE 产生 一 个 setrange 通知 。 

INCR, DECR, INCRBY 和 DECRBY 都 产生 incrby 通知 。 

INCRBYFLOAT 产生 incrbyfloat 通知 。 

APPEND 产生 append 通知 。 

LPUSH 和 LPUSHX 都 产生 单个 ipush 通知 ， 即 使 有 多 个 输入 元 素 时 ， 也 是 如 此 。 
RPUSH 和 RPUSHX 都 产生 单个 rpush 通知 ， 即 使 有 多 个 输入 元 素 时 ， 也 是 如 此 。 
RPOP 产生 rpop 通知 。 如 果 被 弹出 的 元 素 是 列表 的 最 后 一 个 元 素 ， 那 么 还 会 产生 一 个 
del 通知 。 

LPOP 产生 lpop 通知 。 如 果 被 弹出 的 元 素 是 列表 的 最 后 一 个 元 素 ， 那 么 还 会 产生 一 个 
del 通知 。 

LINSERT 产生 一 个 linsert 通知 。 

LSET 产生 一 个 1lset 通知 。 

LTRIM 产生 一 个 itrim 通知 。 如 果 LTRIM 执行 之 后 ， 列 表 键 被 清空 ， 那 么 还 会 产生 一 
个 del 通知 。 

RPOPLPUSH 和 BRPOPLPUSH 产生 一 个 rpop 通知 ， 以 及 一 个 lpush 通知 。 两 个 命 
兮 都 会 保证 rpop 的 通知 在 lpush 的 通知 之 前 分 发 。 如 果 从 键 弹出 元 素 之 后 ， 被 弹出 
的 列表 键 被 清空 ， 那 么 还 会 产生 一 个 del 通知 。 

HSET 、HSETNX 和 HMSET 都 只 产生 一 个 hset 通知 。 

HINCRBY 产生 一 个 hincrby 通知 。 

HINCRBYFLOAT 产生 一 个 hincrbyfloat 通知 。 

HDEL 产生 一 个 hdel 通知 。 如 果 执 行 HDEL 之 后 ， 哈 希 键 被 清空 ， 那 么 还 会 产生 一 个 


del 通知 。 

e SADD 产生 一 个 sadd 通知 ， 即 使 有 多 个 输入 元 素 时 ， 也 是 如 此 。 

e SREM 产生 一 个 srem 通知 ， 如 果 执 行 SREM 之 后 ， 集 合 键 被 清空 ， 那 么 还 会 产生 一 个 
del 通知 。 

e SMOVE 为 来 源 键 (source key) 产生 一 个 srem 通知 ， 并 为 目标 键 (destination key) 
产生 一 个 sadd 事件 。 

e SPOP 产生 一 个 spop 事件 。 如 果 执行 SPOP 之 后 ， 集 合 键 被 清空 ， 那 么 还 会 产生 一 个 
del 通知 。 

e SINTERSTORE 、SUNIONSTORE 和 SDIFFSTORE 分 别 产生 sinterstore 、 
sunionostore 和 sdiffstore 三 种 通知 。 如 果 用 于 保存 结果 的 键 已 经 存在 ， 那 么 还 会 产 
生 一 个 del 通知 。 

e ZINCRBY 产生 一 个 zincr 通知 。 (译注 : 非 对 称 ， 请 注意 。) 

。 ZADD 产生 一 个 zadd 通知 ， 即 使 有 多 个 输入 元 素 时 ， 也 是 如 此 。 

٠ ZREM 产生 一 个 zrem 通知 ， 即 使 有 多 个 输入 元 素 时 ， 也 是 如 此 。 如 果 执 行 ZREM 之 
后 ， 有 序 集合 键 被 清空 ， 那 么 还 会 产生 一 个 del 通知 。 

e ZREMRANGEBYSCORE 产生 一 个 zrembyscore 通知 。 (译注 : 非 对 称 ， 请 注意 。 ) 
如 果 用 于 保存 结果 的 键 已 经 存在 ， 那 么 还 会 产生 一 个 del 通知 。 

e ZREMRANGEBYRANK 产生 一 个 zrembyrank 通知 。 (译注 : 非 对 称 ， 请 注意 。) 如 果 
用 于 保存 结果 的 键 已 经 存在 ， 那 么 还 会 产生 一 个 del 通知 。 

。 ZINTERSTORE 和 ZUNIONSTORE 分 别 产生 zinterstore 和 zunionstore 两 种 通知 。 
如 果 用 于 保存 结果 的 键 已 经 存在 ， 那 么 还 会 产生 一 个 del 通知 。 

。 每 当 一 个 键 因为 过 期 而 被 删除 时 ， 产 生 一 个 expired 通知 。 

。 每 当 一 个 键 因 为 maxmemory 政策 而 被 删除 以 回收 内 存 时 ， 产 生 一 个 evicted 通知 。 


Note 
所 有 命令 都 只 在 键 真 的 被 改动 了 之 后 ， 才 会 产生 通知 。 


比如 说 ， 当 SREM eN 出 除 操 作 会 执行 失败 ， 因 为 没有 真正 的 
改动 键 ， 所 以 这 一 操作 不 会 发 送 通 知 。 


如 果 对 命令 所 产生 的 通知 有 疑问 ， 最 好 还 是 使 用 以 下 命令 ， 自己 来 验证 一 下 : 


$ redis-cli config set notify-keyspace-events KEA 
$ redis-cli --csv psubscribe '_ key*_:*' 

Reading messages... (press Ctrl-C to quit) 
"osubscribe"," key*__:*",14 


然后 ， 只 要 在 其 他 终端 里 用 Redis 客户 端 发 送 命 售 ， 就 可 以 看 到 产生 的 通知 了 : 


"pmessage"," _key*_:*"," _keyspace@0_:foo", "set" 
"omessage"," _key*_:*"," _keyevent@0_:set", "foo" 








过 期 通知 的 发 送 时 间 
Redis 使 用 以 下 两 种 方式 删除 过 期 的 键 : 


。 当 一 个 键 被 访问 时 ， 程 序 会 对 这 个 键 进行 检查 ， 如 果 键 已 经 过 期 ， 那 么 该 键 籽 被 删除 。 
٠ 底层 系统 会 在 后 台 渐 进 地 查找 并 删除 那些 过 期 的 键 ， 从 而 义理 那些 已 经 过 期 、 但 是 不 会 
被 访问 到 的 键 。 
当 过 期 键 被 以 上 两 个 程序 的 任意 一 个 发 现 、 并 且 将 键 从 数据 库 中 删除 时 ， Redis 会 产生 一 个 


expired 通知 。 


Redis 并 不 保证 生存 时 间 (TTL) 变 为 o 的 键 会 立即 被 删除 : 如 果 程 序 没 有 访问 这 个 过 期 
se, 或 者 带 有 生存 时 间 的 键 非常 多 的 话 ， 那么 在 键 的 生存 时 间 变 为 o, 直到 键 真正 被 删除 
这 中 间 ， 可 能 会 有 一 段 比 较 显著 的 时 间 间 隔 。 


因此 ， Redis 产生 expired 通知 的 时 间 为 过 期 键 被 删除 的 时 候 ， 而 不 是 键 的 生存 时 间 变 为 
o 的 时 候 。 


事务 (transaction) 


Note 

本 文档 翻译 自 : http://redis.io/topics/transactions o 

MULTI、 EXEC 、 DISCARD 和 WATCH 是 Redis 事务 的 基础 。 
事务 可 以 一 次 执行 多 个 命令， 并 且 带 有 以 下 两 个 重要 的 保证 : 


。 事务 是 一 个 单独 的 隔离 操作 : 事务 中 的 所 有 命令 都 会 序列 化 、 按 顺序 地 执行 。 事 务 在 执 
行 的 过 程 中 ， 不 会 被 其 他 客户 端 发 送 来 的 命令 请 求 所 打 断 。 


。 事务 是 一 个 原子 操作 : 事务 中 的 命令 要 么 全 部 被 执行 ， 要 么 全 部 都 不 执行 。 
EXEC 命令 负责 触发 并 执行 事务 中 的 所 有 命令 : 


o 如 果 客 户 端 在 使 用 MULTI 开店 了 一 个 事务 之 后 ， 却 因为 断 线 而 没有 成 功 执行 EXEC 
， 那 么 事务 中 的 所 有 命令 都 不 会 被 执行 。 

o 另 一 方面 ， 如 果 客 户 端 成 功 在 开启 事务 之 后 执行 EXEC ， 那 么 事务 中 的 所 有 命令 都 
会 被 执行 。 

当 使 用 AOF 方式 做 持久 化 的 时 候 ， Redis 会 使 用 单个 write(2) 命令 将 事务 写 入 到 磁盘 

中 。 


然而 ， 如 果 Redis 服务 器 因为 某 些 原 因 被 管理 员 杀 死 ， 或 者 遇 上 某 种 硬件 故障 ， 那 么 可 
能 只 有 部 分 事务 命令 会 被 成 功 写 人 到 磁盘 中 。 

如 果 Redis 在 重新 启动 时 发 现 AOF 文件 出 了 这 样 的 问题 ， 那 么 它 会 退出 ， 并 汇报 一 个 错 
Iko 

使 用 redis-check-aof 程序 可 以 修复 这 一 问题 : 它 会 移 除 AOF 文件 中 不 完整 事务 的 信 
息 ， 确 保 服 务 器 可 以 顺利 启动 。 


从 2.2 版 本 开始 ，Redis 还 可 以 通过 乐观 锁 (optimistic lock) 实现 CAS (check-and-set) 操 
作 ， 具 体 信息 请 参考 文档 的 后 半 部 分 。 


用 法 

MULTI 命 合用 于 开启 一 个 事务 ， 它 总 是 返回 ok o 

MULTI 执行 之 后 ， 客户 端 可 以 继续 向 服务 器 发 送 任意 多 条 命令 ， 这 些 命令 不 会 立即 被 执行 ， 
而 是 被 放 到 一 个 队列 中 ， 当 EXEC 命令 被 调用 时 ， 所 有 队列 中 的 命令 才 会 被 执行 。 


另 一 方面 ， 通过 调用 DISCARD, 客户 端 可 以 清空 事务 队列 ， 并 放弃 执行 事务 。 


以 下 是 一 个 事务 例子 ， 它 原子 地 增加 了 foo 和 bar 两 个 键 的 值 : 


> MULTI 
OK 


> INCR foo 
QUEUED 


> INCR bar 
QUEUED 


> EXEC 


1) (integer) 1 
2) (integer) 1 


EXEC 命令 的 回复 是 一 个 数组 ， 数组 中 的 每 个 元 素 都 是 执行 事务 中 的 命令 所 产生 的 回复 。 其 
中 ， 回复 元 素 的 先后 顺序 和 命令 发 送 的 先后 顺序 一 致 。 


当 客户 端 处 于 事务 状态 时 ， 所 有 传人 的 命令 都 会 返回 一 个 内 容 为 ”QuEuUED 的 状态 回复 
(status reply) , 这 些 被 入 队 的 命令 将 在 EXEC 命令 被 调用 时 执行 。 


事务 中 的 错误 
使 用 事务 时 可 能 会 遇 上 以 下 两 种 错误 : 


٠ 事务 在 执行 EXEC 之 前 ， 入 队 的 命令 可 能 会 出 错 。 比 如 说 ， 命 令 可 能 会 产生 语法 错误 
(参数 数量 错误 ， 参 数 名 错误 ， 等 等 ) ， 或 者 其 他 更 严重 的 错误 ， 上 比如 内 存 不 足 (如 果 
服务 器 使 用 maxmemory 设置 了 最 大 内 存 限制 的 话 ) 。 

٠ 命令 可 能 在 EXEC 调用 之 后 失败 。 举 个 例子 ， 事 务 中 的 命 合 可 能 处 理 了 错误 类 型 的 键 ， 
比如 将 列表 命令 用 在 了 字符 串 键 上 面 ， 诸 如 此 类 。 


对 于 发 生 在 EXEC 执行 之 前 的 错误 ， 客 户 端 以 前 的 做 法 是 检查 命令 入 队 所 得 的 返回 值 : 如 果 
命令 入 队 时 返回 queveo ， 那 么 入 队 成 功 ; 否则 ， 就 是 和 人 队 失 败 。 如 果 有 命令 在 人 队 时 失 
败 ， 那 么 大 部 分 客户 端 都 会 停止 并 取消 这 个 事务 。 


不 过 ， 从 Redis 2.6.5 开始 ， 服 务 器 会 对 命令 入 队 失 败 的 情况 进行 记录 ， 并 在 客户 端 调用 
EXEC 命 舍 时 ， 拒 绝 执 行 并 自动 放弃 这 个 事务 。 

在 Redis 2.6.5 以 前 ， Redis 只 执行 事务 中 那些 入 队 成 功 的 命 伟 ， 而 忽略 那些 入 队 失败 的 命 
So 而 新 的 处 理 方式 则 使 得 在 流水 线 (pipeline) 中 包含 事务 变 得 简单 ， 因 为 发 送 事务 和 读 取 
事务 的 回复 都 只 需要 和 服务 器 进行 一 次 通讯 。 

至 于 那些 在 EXEC 命令 执行 之 后 所 产生 的 错误 ， 并 没有 对 它们 进行 特别 处 理 : 即使 事务 中 有 
某 个 / 某 些 命令 在 执行 时 产生 了 错误 ， 事务 中 的 其 他 命令 仍然 会 继续 执行 。 

从 协议 的 角度 来 看 这 个 问题 ， 会 更 容易 理解 一 些 。 以 下 例子 中 ， LPOP 命令 的 执行 将 出 错 ， 
尽管 调用 它 的 语法 是 正确 的 : 


Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 


MULTI 
+0K 


SET a 3 
abc 


+QUEUED 
LPOP a 


+QUEUED 
EXEC 


*2 
+0K 
-ERR Operation against a key holding the wrong kind of value 


EXEC 返回 两 条 批量 回复 (bulkreply) : 第 一 条 是 ok ， 而 第 二 条 是 -ER 。 至 于 怎样 用 
合适 的 方法 来 表示 事务 中 的 错误 ， 则 是 由 客户 端 自己 决定 的 。 


最 重要 的 是 记 住 这 样 一 条 ， 即使 事务 中 有 某 条 / 某 些 命令 执行 失败 了 ， 事务 队列 中 的 其 他 命令 
仍然 会 继续 ee ee 了 事务 中 的 命令 。 


以 下 例子 展示 的 是 另 一 种 情况 ， 当 命 令 在 人 队 时 产生 错误 ， 错误 会 立即 被 返回 给 客户 端 
MULTI 
+0K 


INCR abc 
-ERR wrong number of arguments for 'incr' command 


因为 调用 INCR 命令 的 参数 格式 不 正确 ， 所 以 这 个 INCR 命 合 入 队 失 败 。 


为 什么 Redis 不 支持 回 深 (roll back) 


如 果 你 有 使 用 关系 式 数 据 库 的 经 验 ， 那么 “Redis 在 事务 失败 时 不 进行 回 滚 ， 而 是 继续 执行 余 
下 的 命令 "这 种 做 法 可 能 会 让 你 觉得 有 点 奇怪 。 


以 下 是 这 种 做 法 的 优点 : 


٠ Redis 命令 只 会 因为 错误 的 语法 而 失败 〈 并 且 这 些 问题 不 能 在 和 人 队 时 发 现 ) ， 或 是 命令 
在 了 错误 类 型 的 键 上 面 : 这 也 就 是 说 ， 从 实用 性 的 角度 来 说 ， 失 败 的 命令 是 由 编程 错误 
ann 而 这 些 错误 应 该 在 开发 的 过 程 中 被 发 现 ， 而 不 应 该 出 现在 生产 环境 中 。 

٠ 因为 不 需要 对 回 滚 进 行 支持 ， 所 以 Redis 的 内 部 可 以 保持 简单 且 快 速 。 


有 种 观点 认为 Redis 处 理事 务 的 做 法 会 产生 bug, 然而 需要 注意 的 是 ， 在 通常 情况 下 ， 回 
滚 并 不 能 解决 编程 错误 带 来 的 问题 。 举 个 例子 ， 如 果 你 本 来 想 通过 INCR 命令 将 键 的 值 加 上 
1, 却 不 小 心 加 上 了 2, 又 或 者 对 错误 类 型 的 键 执行 了 INCR ， 回 滚 是 没有 办 法 处 理 这 


些 情况 的 。 


鉴于 没有 任何 机 制 能 避免 程序 员 自 己 造成 的 错误 ， 并 且 这 类 错误 通常 不 会 在 生产 环境 中 出 
现 ， 所 以 Redis 选择 了 更 简单 、 更 快速 的 无 回 滚 方式 来 处 理事 务 。 


放弃 事务 


当 执 行 DISCARD 命令 时 ， 事务 会 被 放弃 ， 事务 队列 会 被 清空 ， 并 且 客 户 端 会 从 事务 状态 中 
退出 : 

redis> SET foo 1 

OK 


redis> MULTI 
OK 


redis> INCR foo 
QUEUED 


redis> DISCARD 
OK 


redis> GET foo 
Wee 


使 用 check-and-set 操作 实现 乐观 锁 


WATCH 命令 可 以 为 Redis 事务 提供 check-and-set (CAS) 行为 。 


被 WATCH 的 键 会 被 监视 ， 并 会 发 觉 这些 键 是 否 被 改动 过 了 。 如 果 有 至 少 一 个 被 监视 的 键 在 
EXEC 执行 之 前 被 修改 了 ， 那么 整个 事务 都 会 被 取消 ， EXEC 返回 空 多 条 批量 回复 (null 
multi-bulk reply) 来 表示 事务 已 经 失败 。 


举 个 例子 ， 假设 我 们 需要 原子 性 地 为 某 个 值 进行 增 1 操作 (假设 INCR 不 存在 ) 。 
首先 我 们 可 能 会 这 样 做 : 


val = GET mykey 
val = val + 1 
SET mykey $val 


上 面 的 这 个 实现 在 只 有 一 个 客户 端的 时 候 可 以 执行 得 很 好 。 但 是 ， 当 多 个 客户 端 同时 对 同一 
个 键 进行 这 样 的 操作 时 ， 就 会 产生 竞争 条 件 。 


举 个 例子 ， 如 果 客 户 端 A 和 Bi 都 读 取 了 键 原来 的 值 ， 比 如 16 , 那么 两 个 客户 端 都 会 将 键 
的 值 设 为 11 , 但 正确 的 结果 应 该 是 12 才 对 。 


有 了 WATCH, 我 们 就 可 以 轻松 地 解决 这 类 问题 了 : 


WATCH mykey 


val 
val 


GET mykey 
val + 1 


MULTI 
SET mykey $val 
EXEC 


使 用 上 面 的 代码 ， 如 果 在 WATCH 执行 之 后 ， EXEC 执行 之 前 ， 有 其 他 客户 端 修改 了 
mykey 的 值 ， 那么 当前 客户 端的 事务 就 会 失败 。 程序 需要 做 的 ， 就 是 不 断 重 试 这 个 操作 ， 
直到 没有 发 生 碰撞 为 止 。 


这 种 形式 的 锁 被 称 作乐 观 锁 ， 它 是 一 种 非常 强大 的 锁 机 制 。 并 且 因 为 大 多 数 情况 下 ， 不 同 的 
客户 端 会 访问 不 同 的 键 ， 碰撞 的 情况 一 般 都 很 少 ， 所 以 通常 并 不 需要 进行 重 试 。 


了 解 WATCH 

WATCH 使 得 EXEC 命令 需要 有 条 件 地 执行 : 事务 只 能 在 所 有 被 监视 键 都 没有 被 修改 的 前 提 
下 执行 ， 如 果 这 个 前 提 不 能 满足 的 话 ， 事 务 就 不 会 被 执行 。 

Note 


如 果 你 使 用 WATCH 监视 了 一 个 带 过 期 时 间 的 键 ， 那么 即使 这 个 键 过 期 了 ， 事务 仍然 可 以 正 
常 执行 ， 关于 这 方面 的 详细 情况 ， 请 看 这 个 帖子 : 
http://code.google.com/p/redis/issues/detail?id=270 


WATCH 命令 可 以 被 调用 多 次 。 对 键 的 监视 从 WATCH 执行 之 后 开始 生效 ， 直到 调用 EXEC 
为 止 。 


用 户 还 可 以 在 单个 WATCH 命令 中 监视 任意 多 个 键 ， 就 像 这 样 : 


redis> WATCH key1 key2 key3 
OK 


4 EXEC 被 调用 时 ， 不 管事 务 是 否 成 功 执行 ， 对 所 有 键 的 监视 都 会 被 取消 。 
另外 ， 当 客户 端 断 开 连接 时 ， 该 客户 端 对 键 的 监视 也 会 被 取消 。 


使 用 无 参数 的 UNWATCH 命令 可 以 手动 取消 对 所 有 键 的 监视 。 对 于 一 些 需 要 改动 多 个 键 的 事 
务 ， 有 时 候 程 序 需 要 同时 对 多 个 键 进行 加 锁 ， 然后 检查 这 些 键 的 当前 值 是 否 符合 程序 的 要 
Ko 当 值 达 不 到 要 求 时 ， 就 可 以 使 用 UNWATCH 命令 来 取消 目前 对 键 的 监视 ， 中 途 放 弃 这 
个 事务 ， 并 等 待 事务 的 下 次 尝试 。 


使 用 WATCH 实现 ZPOP 


WATCH 可 以 用 于 创建 Redis 没有 内 置 的 原子 操作 。 


举 个 例子 ， 以 下 代码 实现 了 原创 的 zo 命令 ， 它 可 以 原子 地 弹出 有 序 集合 中 分 值 
(score) 最 小 的 元 素 : 


WATCH zset 
element = ZRANGE zset 0 0 
MULTI 

ZREM zset element 
EXEC 


程序 只 要 重复 执行 这 段 代 码 ， 直到 EXEC 的 返回 值 不 是 空 多 条 回复 (null multi-bulk reply) 
即 可 。 


Redis 脚本 和 事务 


从 定义 上 来 说 ， Redis 中 的 脚本 本 身 就 是 一 种 事务 ， 所 以 任何 在 事务 里 可 以 完成 的 事 ， 在 脚 
本 里 面 也 能 完成 。 并 且 一 般 来 说 ， 使 用 脚本 要 来 得 更 简单 ， 并 且 速 度 更 快 。 


因为 脚本 功能 是 Redis 2.6 才 引 入 的 ， 而 事务 功能 则 更 早 之 前 就 存在 了 ， 所 以 Redis 才 会 同 
时 存在 两 种 处 理事 务 的 方法 。 

不 过 我 们 并 不 打算 在 短 时 间 内 就 移 除 事务 功能 ， 因为 事务 提供 了 一 种 即使 不 使 用 脚本 ， 也 可 
以 避免 竞争 条 件 的 方法 ， 而 且 事务 本 身 的 实现 并 不 复 杀 。 

不 过 在 不 远 的 将 来 ， 可 能 所 有 用 户 都 会 只 使 用 脚本 来 实现 事务 也 说 不 定 。 如 果真 的 发 生 这 种 
情况 的 话 ， 那么 我 们 将 废弃 并 最 终 移 除 事务 功能 。 


发 布 与 订阅 (pub/sub) 


Note 
本 文档 翻译 自 : http://redis.io/topics/pubsub 。 


SUBSCRIBE, UNSUBSCRIBE 和 PUBLISH 三 个 命令 实现 了 发 布 与 订阅 信息 泛 型 
(Publish/Subscribe messaging paradigm) ， 在 这 个 实现 中 ， 发 送 者 (发 送信 息 的 客户 
im) 不 是 将 信息 直接 发 送 给 特定 的 接收 者 (接收 信息 的 客户 端 ， 而 是 将 信息 发 送 给 频道 
(channel) , 然后 由 频道 将 信息 转发 给 所 有 对 这 个 频道 感 兴趣 的 订阅 者 。 


发 送 者 无 须知 道 任 何 关 于 订阅 者 的 信息 ， 而 订阅 者 也 无 须知 道 是 那个 客户 端 给 它 发 送信 息 ， 
它 只 要 关注 自己 感 兴趣 的 频道 即 可 。 


对 发 布 者 和 订阅 者 进行 解构 (decoupling) , 可 以 极 大 地 提高 系统 的 扩展 性 (scalability) , 
并 得 到 一 个 更 动态 的 网 络 拓扑 (network topology) o 


比如 说 ， 要 订阅 频道 foo 和 ba , 客户 端 可 以 使 用 频道 名 字 作 为 参数 来 调用 
SUBSCRIBE 命令 : 


redis> SUBSCRIBE foo bar 


当 有 客户 端 发 送信 息 到 这 些 频 道 时 ， Redis 会 将 传 入 的 信息 推送 到 所 有 订阅 这 些 频 道 的 客户 
端 里 面 。 

正在 订阅 频道 的 客户 端 不 应 该 发 送 除 SUBSCRIBE 和 UNSUBSCRIBE 之 外 的 其 他 命令 。 其 
fh, SUBSCRIBE 可 以 用 于 订阅 更 多 频道 ， 而 UNSUBSCRIBE 则 可 以 用 于 退 订 已 订阅 的 一 
个 或 多 个 频道 。 


SUBSCRIBE 和 UNSUBSCRIBE 的 执行 结果 会 以 信息 的 形式 返回 ， 客户 端 可 以 通过 分 析 所 
接收 信息 的 第 一 个 元 素 ， 从 而 判断 所 收 到 的 内 容 是 一 条 真正 的 信息 ， 还 是 SUBSCRIBE 或 
UNSUBSCRIBE 命 使 的 操作 结果 。 


信息 的 格式 
频道 转发 的 每 条 信息 都 是 一 条 带 有 三 个 元 素 的 多 条 批量 回复 (multi-bulk reply) 。 
信息 的 第 一 个 元 素 标识 了 信息 的 类 型 : 


© subscribe : 表示 当前 客户 端 成 功 地 订 阅 了 信息 第 二 个 元 素 所 指示 的 频道 。 而 信息 的 第 
三 个 元 素 则 记录 了 目前 客户 端 已 订阅 频道 的 总 数 。 
© unsubscribe : 表示 当前 客户 端 成 功 地 退 订 了 信息 第 二 个 元 素 所 指示 的 频道 。 信息 的 第 


三 个 元 素 记 录 了 客户 端 目前 仍 在 订阅 的 频道 数量 。 当 客 户 端 订阅 的 频道 数量 降 为 o 
时 ， 客户 端 不 再 订阅 任何 频道 ， 它 可 以 像 往常 一 样 ， 执行 任何 Redis #43. 
e message : 表示 这 条 信息 是 由 某 个 客户 端 执 行 PUBLISH 命令 所 发 送 的 ， 真正 的 信息 。 
信息 的 第 二 个 元 素 是 信息 来 源 的 频道 ， 而 第 三 个 元 素 则 是 信息 的 内 容 。 


举 个 例子 ， 如 果 客 户 端 执行 以 下 命令 : 


redis> SUBSCRIBE first second 


那么 它 将 收 到 以 下 回复 : 


1) "subscribe" 
2) firsti 

3) (integer) 1 
1) "subscribe" 


2) "second" 
3) (integer) 2 


如 果 在 这 时 ， 另 一 个 客户 端 执 行 以 下 PUBLISH 命令 : 


redis> PUBLISH second Hello 


那么 之 前 订阅 了 second 频道 的 客户 端 将 收 到 以 下 信息 : 


1) "message" 
2) "second" 
3) "hello" 


当 订阅 者 决定 退 订 所 有 频道 时 ， 它 可 以 执行 一 个 无 参数 的 UNSUBSCRIBE 命令 : 


redis> UNSUBSCRIBE 


这 个 命令 将 接 到 以 下 回复 : 


1) "unsubscribe" 
2) "second" 
3) (integer) 1 


1) "unsubscribe" 


2) "first" 
3) (integer) 0 


订阅 模式 


Redis 的 发 布 与 订阅 实现 支持 模式 匹配 (pattern matching) : 客户 端 可 以 订阅 一 个 带 + 号 
的 模式 ， 如 果 某 个 / 某 些 频 道 的 名 字 和 这 个 模式 匹配 ， 那么 当 有 信息 发 送 给 这 个 /这 些 频 道 的 
ate, 客户 端 也 会 收 到 这 个 /这 些 频 道 的 信息 。 


比如 说 ， 执 行 命 兮 


redis> PSUBSCRIBE news. . * 


的 客户 端 将 收 到 来 自 news.art.figurative 、 news.music. jazz 等 频道 的 信息 。 


客户 端 订 阅 的 模式 里 面 可 以 包含 多 个 glob 风格 的 通配符 ， 上 比如 * . ?和 [...] ， 等 
等 。 


执行 命令 


redis> PUNSUBSCRIBE news . * 


将 退 订 news.* 模式 ， 其 他 已 订阅 的 模式 不 会 被 影响 。 
通过 订阅 模式 接收 到 的 信息 ， 和 通过 订阅 频道 接收 到 的 信息 ， 这 两 者 的 格式 不 太一 样 : 


。 通过 订阅 模式 而 接收 到 的 信息 的 类 型 为 pmessage : 这 代表 有 某 个 客户 端 通过 PUBLISH 
向 某 个 频道 发 送 了 信息 ， 而 这 个 频道 刚好 匹配 了 当前 客户 端 所 订阅 的 某 个 模式 。 信息 的 
第 二 个 元 素 记 录 了 被 匹配 的 模式 ， 第 三 个 元 素 记 录 了 被 匹配 的 频道 的 名 字 ， 最 后 一 
素 则 记录 了 信息 的 实际 内 容 。 


PSUBSCRIBE 和 PUNSUBSCRIBE JRE GHA, AWE Pima SUBSCRIBE‏ مث يوز حر جد 
和 UNSUBSCRIBE 的 方式 类 似 : 通过 对 信息 的 第 一 个 元 素 进 行 分 析 ， 客户 端 可 以 判断 接收‏ 
到 的 信息 是 一 个 真正 的 信息 ， 还 是 PSUBSCRIBE 或 PUNSUBSCRIBE 命令 的 返回 值 。‏ 


页 道 和 模式 接收 同一 条 信息 


如 果 客 户 端 订 阅 的 多 个 模式 匹配 了 同一 个 频道 ， 或 者 客户 端 同 时 订阅 了 某 个 频道 、 以 及 匹配 
这 个 频道 的 某 个 模式 ， 那么 它 可 能 会 多 次 接收 到 同一 条 信息 。 
举 个 例子 ， 如 果 客 户 端 执 行 了 以 下 命令 : 


SUBSCRIBE foo 
PSUBSCRIBE f* 


那么 当 有 信息 发 送 关 到 频道 foo 时 ， للا وم لاخر جد‎ Sl ع2 ور‎ 15 3 : 一 条 来 自 频道 foo ， 信息 类 
型 为 message : 另 一 条 来 自 模式 f* ， 信 息 类 型 为 pmessage o 


订阅 总 数 
在 执行 SUBSCRIBE 、 UNSUBSCRIBE, PSUBSCRIBE 和 PUNSUBSCRIBE 命令 时 ， 返 
回 结果 的 最 后 一 个 元 素 是 客户 端 目 前 仍 在 订阅 的 频道 和 模式 总 数 。 


当 客户 端 退 订 所 有 频道 和 模式 ， 也 即 是 这 个 总 数值 下 降 为 o 的 时 候 ， 客户 端 将 退出 订阅 与 
发 布 状态 。 


编程 示例 


Pieter Noordhuis 提供 了 一 个 使 用 EventMachine 和 Redis 编写 的 高 性 能 多 用 户 网 页 聊天 软 
F, 这 个 软件 很 好 地 展示 了 发 布 与 订阅 功能 的 用 法 。 


客户 端 库 实现 提示 
为 所 有 接收 到 的 信息 都 会 包含 一 个 信息 来 源 : 


。 当 信 息 来 自 频道 时 ， 来 源 是 某 个 频道 ; 
。 当 信 息 来 自 模式 时 ， 来 源 是 某 个 模式 。 


Alt, 客户 端 可 以 用 一 个 哈 希 表 ， 将 特定 来 源 和 人 处理 该 来 源 的 回调 画 数 关联 起 来 。 当 有 新 信 
息 到 达 时 ， 程序 就 可 以 根据 信息 的 来 源 ， 在 O(1) 复杂 度 内 ， 将 信息 交 给 正确 的 回调 函数 来 
处 理 。 


复制 (Replication) 


Note 
本 文档 翻译 自 : http://redis.io/topics/replication o 


Redis 支持 简单 且 易 用 的 主 从 复制 (master-slave replication) 功能 ， 该 功能 可 以 让 从 服务 器 
(slave server) 成 为 主 服 务 器 (master server) 的 精确 复制 品 。 


以 下 是 关于 Redis 复制 功能 的 几 个 重要 方面 : 


。 Redis 使 用 异步 复制 。 从 Redis 2.8 开始 ， 从 服务 器 会 以 每 秒 一 次 的 频率 向 主 服 务 器 报 
告 复制 流 (replication stream) 的 处 理 进度 。 


。 一 个 主 服务 器 可 以 有 多 个 从 服务 器 。 


。 不 仅 主 服务 器 可 以 有 从 服务 器 ， 从 服务 器 也 可 以 有 自己 的 从 服务 器 ， 多 个 从 服务 器 之 间 
可 以 构成 一 个 图 状 结构 。 


٠ 复制 功能 不 会 阻塞 主 服 务 器 : 即使 有 一 个 或 多 个 从 服务 器 正在 进行 初次 同步 ， 主 服务 器 
也 可 以 继续 处 理 命令 请 求 。 

٠ 复制 功能 也 不 会 阻塞 从 服务 器 : 只 要 在 redis.conf 文件 中 进行 了 相应 的 设置 ， 即使 从 
服务 器 正在 进行 初次 同步 ， 服务 器 也 可 以 使 用 旧版 本 的 数据 集 来 处 理 命令 查 询 。 


不 过 ， 在 从 服务 器 删除 旧版 本 数据 集 并 载 和 人 新 版 本 数据 集 的 那 段 时 间 内 ， 连接 请 求 会 被 
阻塞 。 


你 还 可 以 配置 从 服务 器 ， 让 它 在 与 主 服务 器 之 间 的 连接 断 开 时 ， 向 客户 端 发 送 一 个 错 
Iko 


٠ 复制 功能 可 以 单纯 地 用 于 数据 宛 余 (data redundancy) , 也 可 以 通过 让 多 个 从 服务 器 处 
理 只 读 命令 请 求 来 提升 扩展 性 (scalability) : 比如 说 ， 繁重 的 SORT 命令 可 以 交 给 附 
属 节点 去 运行 。 

٠ 可 以 通过 复制 功能 来 让 主 服务 器 免 于 执行 持久 化 操作 : 只 要 关闭 主 服务 器 的 持久 化 功 
能 ， 然后 由 从 服务 器 去 执行 持久 化 操作 即 可 。 


天 闭 主 服务 器 持久 化 时 ， 复 制 功 能 的 效 据 安全 


当 配 置 Redis 复 制 功 能 时 ， 强 烈 建议 打开 主 服务 器 的 持久 化 功能 。 否则 的 话 ， 由 于 延迟 等 问 
题 ， 部 署 的 服务 应 该 要 避免 自动 拉 起 。 


为 了 帮助 理解 主 服务 器 关闭 持久 化 时 自动 拉 起 的 危险 性 ， 参 考 一 下 以 下 会 导致 主 从 服务 器 数 
据 全 部 丢失 的 例子 : 


1. 假设 节点 A 为 主 服务 器 ， 并 且 关 闭 了 持久 化 。 并 且 节 点 B 和 节点 C 从 节点 A 复制 数据 


2. 节点 人 崩溃， 然后 由 自动 拉 起 服务 重启 了 节点 A. 由 于 节点 A 的 持久 化 被 关闭 了 ， 所 以 重启 之 
后 没有 任何 数据 


3. 节点 B 和 节点 C 将 从 节点 A 复制 数据 ， 但 是 A 的 数据 是 空 的 ， 于 是 就 把 自身 保存 的 数据 副本 
MIRR. 


在 关闭 主 服务 器 上 的 持久 化 ， 并 同时 开启 自动 拉 起 进程 的 情况 下 ， 即 便 使 用 Sentine| 来 实现 
Redis 的 高 可 用 性 ， 也 是 非常 危险 的 。 因为 主 服 务 器 可 能 拉 起 得 非常 快 ， 以 至 于 Sentinel 在 配 
置 的 心跳 时 间 间 隔 内 没有 检测 到 主 服 务 器 已 被 重启 ， 然 后 还 是 会 执行 上 面 的 数据 丢失 的 流 


程 。 


无 论 何 时 ， 数 据 安全 都 是 极其 重要 的 ， 所 以 应 该 禁止 主 服 务 器 关闭 持久 化 的 同时 自动 拉 起 。 


复制 功能 的 运作 原理 


无 论 是 初次 连接 还 是 重新 连接 ， 当 建 立 一 个 从 服务 器 时 ， 从 服务 器 都 将 向 主 服 务 器 发 送 一 个 
SYNC #747. 


接 到 SYNC 命令 的 主 服务 器 将 开始 执行 BGSAVE , 并 在 保存 操作 执行 期 间 ， 将 所 有 新 执行 
的 写 和 命令 都 保存 到 一 个 缓冲 区 里 面 。 


当 BGSAVE 执行 完毕 后 ， 主 服务 器 将 执行 保存 操作 所 得 的 .rdb 文件 发 送 给 从 服务 器 ， 从 
服务 器 接收 这 个 .rdb 文件 ， 并 将 文件 中 的 数据 载 人 到 内 存 中 。 


之 后 主 服 务 器 会 以 Redis 命令 协议 的 格式 ， 将 写 命 令 缓 冲 区 中 积累 的 所 有 内 容 都 发 送 给 从 服 
务 器 。 

你 可 以 通过 telnet 命令 来 亲自 验证 这 个 同步 过 程 : 首先 连 上 一 个 正在 处 理 命令 请 求 的 Redis 

服务 器 ， 然后 向 它 发 送 SYNC 命 舍 ， 过 一 阵子 ， 你 将 看 到 telnet 会 话 (session) 接收 到 服 
务 器 发 来 的 大 段 数据 ( ,rdb 文件 ) ， 之 后 还 会 看 到 ， 所 有 在 服务 器 执行 过 的 写 命 售 ， 都 会 
重新 发 送 到 telnet 会 话 来 。 


即使 有 多 个 从 服务 器 同时 向 主 服务 器 发 送 SYNC ， 主 服务 器 也 只 需 执 行 一 次 BGSAVE 命 
S, 就 可 以 处 理 所 有 这 些 从 服务 器 的 同步 请 求 。 


从 服务 器 可 以 在 主 从 服务 器 之 间 的 连接 断 开 时 进行 自动 重 连 ， 在 Redis 2.8 版 本 之 前 ， 断 线 

之 后 重 连 的 从 服务 器 总 要 执行 一 次 完整 重 同步 (full resynchronization) 操作 ， 但 是 从 Redis 

2.8 版 本 开始 ， 从 服务 器 可 以 根据 主 服务 器 的 情况 来 选择 执行 完整 重 同步 还 是 部 分 重 同步 
(partial resynchronization) 。 


部 分 重 同 步 
从 Redis 2.8 开始 ， 在 网 络 连接 短暂 性 失效 之 后 ， 主 从 服务 器 可 以 党 试 继续 执行 原 有 的 复制 
进程 (process), 而 不 一 定 要 执行 完整 重 同步 操作 。 


这 个 特性 需要 主 服务 器 为 被 发 送 的 复制 流 创建 一 个 内 存 缓冲 区 (in-memory backlog) ， 并且 
主 服 务 器 和 所 有 从 服务 器 之 间 都 记录 一 个 复制 偏 移 量 (replication offset) 和 一 个 主 服务 器 ID 

(master run id) , 当 出 现 网 络 连 接 断 开 时 ， 从 服务 器 会 重新 连接 ， 并 且 向 主 服务 器 请 求 继 
续 执 行 原来 的 复制 进程 : 

٠ 如 果 从 服务 器 记录 的 主 服务 器 ID 和 当前 要 连接 的 主 服务 器 的 ID 相同 ， 并 且 从 服务 器 记 
录 的 偏 移 量 所 指定 的 数据 仍然 保存 在 主 服务 器 的 复制 流 缓冲 区 里 面 ， 那么 主 服务 器 会 向 
从 服务 器 发 送 断 线 时 缺失 的 那 部 分 数据 ， 然后 复制 工作 可 以 继续 执行 。 

٠ 否则 的 话 ， 从 服务 器 就 要 执行 完整 重 同步 操作 。 

Redis 2.8 的 这 个 部 分 重 同步 特性 会 用 到 一 个 新 增 的 PSYNC 内 部 命令 ， 而 Redis 2.8 以 前 的 
旧版 本 只 有 SYNC AS, 不过， 只 要 从 服务 器 是 Redis 2.8 或 以 上 的 版 本 ， 它 就 会 根据 主 
服务 器 的 版 本 来 决定 到 底 是 使 用 PSYNC 还 是 SYNC : 


٠ 如 果 主 服务 器 是 Redis 2.8 或 以 上 版 本 ， 那 么 从 服务 器 使 用 PSYNC 命令 来 进行 同步 。 
٠ 如 果 主 服务 器 是 Redis 2.8 之 前 的 版 本 ， 那 么 从 服务 器 使 用 SYNC 命令 来 进行 同步 。 


Acie 
配置 一 个 从 服务 器 非常 简单 ， 只 要 在 配置 文件 中 增加 以 下 的 这 一 行 就 可 以 了 : 


slaveof 192.168.1.1 9 


当然 ， 你 需要 将 代码 中 的 192.168.1.1 和 6379 蔡 换 成 你 的 主 服务 器 的 IP 和 端口 号 。 
另外 一 种 方法 是 调用 SLAVEOF MD, 输入 主 服 务 器 的 IP 和 端口 ， 然后 同步 就 会 开始 : 


127.0.0.1:6379> SLAVEOF 192.168.1.1 10086 
OK 


Ris MER SF Ae 


从 Redis 2.6 开始 ， 从 服务 器 支持 只 读 模 式 ， 并 且 该 模式 为 从 服务 器 的 默认 模式 。 


只 


pa 


读 模 式 由 redis.conf 文件 中 的 slave-read-only 选项 控制 ， 也 可 以 通过 CONFIG SET 
命令 来 开启 或 关闭 这 个 模式 。 
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只 读 从 服务 器 会 拒绝 执行 任何 写 命 舍 ， 所 以 不 会 出 现 因为 操作 失误 而 将 数据 不 小 心 写 人 到 了 
从 服务 器 的 情况 。 


即使 从 服务 器 是 只 读 的 ， pEBu6 和 conric 等 管理 式 命令 仍然 是 可 以 使 用 的 ， 所 以 我 们 还 
是 不 应 该 将 服务 器 暴露 给 互联 网 或 者 任何 不 可 信 网 络 。 不 过 ， 使 用 redis.conf 中 的 命令 改 
名 选项 ， 我 们 可 以 通过 禁止 执行 某 些 命令 来 提升 只 读 从 服务 器 的 安全 性 。 


你 可 能 会 感到 好 奇 ， 既然 从 服务 器 上 的 写 数 据 会 被 重 同 步 数据 履 盖 ， 也 可 能 在 从 服务 器 重启 
时 丢失 ， 那么 为 什么 要 让 一 个 从 服务 器 变 得 可 写 呢 ? 


原因 是 ， 一 些 不 重要 的 临时 数据 ， 仍然 是 可 以 保存 在 从 服务 器 上 面 的 。 比如 说 ， 客户 端 可 
以 在 从 服务 器 上 保存 主 服务 器 的 可 达 性 (reachability) 信息 ， 从 而 实现 故障 转移 (failover) 
策略 。 


从 服务 器 相关 配置 


如 果 主 服务 器 通过 requirepass 选项 设置 了 密码 ， 那么 为 了 让 从 服务 器 的 同步 操作 可 以 顺利 
进行 ， 我 们 也 必须 为 从 服务 器 进行 相应 的 身份 验证 设置 。 


对 于 一 个 正在 运行 的 服务 器 ， 可 以 使 用 客户 端 输 入 以 下 命 全 


config set masterauth <password> 


要 永久 地 设置 这 个 密码 ， 那么 可 以 将 它 加 入 到 配置 文件 中 : 


masterauth <password> 


另外 还 有 几 个 选项 ， 它们 和 主 服务 器 执行 部 分 重 同步 时 所 使 用 的 复制 流 缓冲 区 有 关 ， 详细 的 
信息 可 以 参考 Redis 源码 中 附带 的 redis.conf 示例 文件 。 


主 服务 器 只 在 有 至 少 N 个 从 服务 器 的 情况 下 ， 才 执行 
写 操 作 

从 Redis 2.8 开始 ， 为 了 保证 数据 的 安全 性 ， 可 以 通过 配置 ， 让 主 服务 器 只 在 有 至 少 N 个 当 
前 已 连接 从 服务 器 的 情况 下 ， TRIIAS, 


不 过 ， 因为 Redis 使 用 异步 复制 ， 所 以 主 服务 器 发 送 的 写 数 据 并 不 一 定 会 被 从 服务 器 接收 
到 ， 因此 ， 数据 丢失 的 可 能 性 仍然 是 存在 的 。 


以 下 是 这 个 特性 的 运作 原理 : 


٠ 从 服务 器 以 每 秒 一 次 的 频率 PING 主 服务 器 一 次 ， 并 报告 复制 流 的 处 理 情况 。 
。 主 服务 器 会 记录 各 个 从 服务 器 最 后 一 次 向 它 发 送 PING 的 时 间 。 


٠ 用 户 可 以 通过 配置 ， 指定 网 络 延迟 的 最 大 值 min-slaves-max-lag , 以 及 执行 守 操 作 所 


需 的 至 少 从 服务 器 数量 min-slaves-to-write o 


如 果 至 少 有 min-slaves-to-write 个 从 服务 器 ， 并 且 这 些 服务 器 的 延迟 值 都 少 于 
min-slaves-max-lag 秒 ， 那么 主 服务 器 就 会 执行 客户 端 请 求 的 写 操 作 。 


你 可 以 将 这 个 特性 看 作 CAP 理论 中 的 C 的 条 件 放宽 版 本 : 尽管 不 能 保证 写 操 作 的 持久 性 ， 
但 起 码 去 失 数据 的 窗口 会 被 严格 限制 在 指定 的 秒 数 中 。 


另 一 方面 ， 如 果 条 件 达 不 到 min-slaves-to-write 和 min-slaves-max-lag 所 指定 的 条 件 ， 
那么 写 操 作 就 不 会 被 执行 ， 主 服务 器 会 向 请 求 执 行 写 操 作 的 客户 端 返回 一 个 错误 。 


以 下 是 这 个 特性 的 两 个 选项 和 它们 所 需 的 参数 : 


© min-slaves-to-write &lt;number of slaves&gt; 


© min-slaves-max-lag &lt;number of seconds&gt; 


详细 的 信息 可 以 参考 Redis 源码 中 附带 的 redis.conf 示例 文件 。 


通信 协议 (protocol) 


Note 
本 文档 翻译 自 : http://redis.io/topics/protocol 。 
Redis 协议 在 以 下 三 个 目标 之 间 进 行 折 中 : 


© 易于 实现 
٠ 可 以 高 效 地 被 计算 机 分 析 (parse) 
٠ 可 以 很 容易 地 被 人 类 读 懂 


网 络 层 


客户 端 和 服务 器 通过 TCP 连接 来 进行 数据 交互 ， 服务 器 默认 的 端口 号 为 6379 。 
客户 端 和 服务 器 发 送 的 命令 或 数据 一 律 以 \r\n (CRLF) 结尾 。 


Redis 服务 器 接受 命令 以 及 命令 的 参数 。 
服务 器 会 在 接 到 命令 之 后 ， 对 命令 进行 父 理 ， 并 将 命令 的 回复 传送 回 客户 端 。 


新 版 统一 请 求 协议 

新 版 统一 请 求 协议 在 Redis 1.2 版 本 中 引入 ， 并 最 终 在 Redis 2.0 版 本 成 为 Redis 服务 器 通信 
的 标准 方式 。 

你 的 Redis 客户 端 应 该 按照 这 个 新 版 协议 来 进行 实现 。 

在 这 个 协议 中 ， 所 有 发 送 至 Redis 服务 器 的 参数 都 是 二 进 制 安全 (binary safe) 的 。 

以 下 是 这 个 协议 的 一 般 形 式 : 


*< 参 数 数 量 > CR LF 
$< 参数 1 的 字 节 数量 > CR LF 
< 参数 1 的 数据 > CR LF 


$< 参数 N 的 字 节 数量 > CR LF 
< 参数 N 的 数据 > CR LF 


Note 


译注 : 命令 本 身 也 作为 协议 的 其 中 一 个 参数 来 发 送 。 


举 个 例子 ， 以 下 是 一 个 命令 协议 的 打印 版 本 : 


myvalue 


这 个 命令 的 实际 协议 值 如 下 : 


"*3\r\n$3\r\nSET\r\n$5\r\nmykey\r\n$7\r\nmyvalue\r\n" 


稍 后 我 们 会 看 到 ， 这 种 格式 除了 用 作 命 邻 请 求 协议 之 外 ， 也 用 在 命令 的 回复 协议 中 : 这 种 只 


有 一 个 参数 的 回复 格式 被 称 为 批量 回复 (Bulk Reply) 。 


统一 协议 请 求 原 本 是 用 在 回复 协议 中 ， 用 于 将 列表 的 多 个 项 返回 给 客户 端的 ， 这 种 回复 格式 


被 称 为 多 条 批量 回复 (Multi Bulk Reply) 。 


一 个 多 条 批量 回复 以 *alt;argceagt;\r\n 为 前 级 ， 后 跟 多 条 不 同 的 批量 回复 ， 其 中 arge 为 


这 些 批量 回复 的 数量 。 


Redis 命令 会 返回 多 种 不 同类 型 的 回复 。 
通过 检查 服务 器 发 回 数据 的 第 一 个 字 节 ， 可 以 确定 这 个 回复 是 什么 类 型 : 


٠ 状态 回复 (status reply) 的 第 一 个 字 节 是 "+" 
e 错误 回复 (error reply) 的 第 一 个 字 节 是 

٠ 整数 回复 (integer reply) 的 第 一 个 字 节 是 ":" 

٠ 批量 回复 (bulk reply) 的 第 一 个 字 节 是 "s" 

。 多 条 批量 回复 (multi bulk reply) 的 第 一 个 字 节 是 "*" 


状态 回复 


一 个 状态 回复 (或 者 单行 回复 ，single line reply) 是 一 段 以 "+" FHA, 
字符 串 。 


以 下 是 一 个 状态 回复 的 例子 : 


+OK 


"mrn" 结尾 的 单 


客户 端 库 应 该 返回 +" 号 之 后 的 所 有 内 容 。 比如 在 在 上 面 的 这 个 例子 中 ， 客户 端 就 应 该 返 
回 字符 串 "ok" o 


状态 回复 通常 由 那些 不 需要 返回 数据 的 命令 返回 ， 这 种 回复 不 是 二 进 制 安全 的 ， 它 也 不 能 
含 新 行 。 


状态 回复 的 额外 开销 非常 少 ， 只 需要 三 个 字 节 (开头 的 "+" 和 结尾 的 CRLF) 。 


错误 回复 
错误 回复 和 状态 回复 非常 相似 ， 它们 之 间 的 唯一 区 别 是 ， 错误 回复 的 第 一 个 字 节 是 "-" ， 
而 状态 回复 的 第 一 个 字 节 是 "+" 。 


错误 回复 只 在 某 些 地 方 出 现 问 题 时 发 送 : 比如 说 ， 当 用 户 对 不 正确 的 数据 类 型 执行 命 分 ， 或 
者 执行 一 个 不 存在 的 命令 ， SS. 


一 个 客户 端 库 应 该 在 收 到 错误 回复 时 产生 一 个 异常 。 


以 下 是 两 个 错误 回复 的 例子 : 


-ERR unknown command 'foobar' 
-WRONGTYPE Operation against a key holding the wrong kind of value 


在 "-" 之 后 ， 直 到 遇 到 第 一 个 空格 或 新 行为 止 ， 这 中 间 的 内 容 表 示 所 返回 错误 的 类 型 。 


ERR 是 一 个 通用 错误 ， 而 wROoNGTYPE 则 是 一 个 更 特定 的 错误 。 一 个 客户 端 实现 可 以 为 不 同 
类 型 的 错误 产生 不 同类 型 的 异常 ， 或 者 提供 一 种 通用 的 方式 ， 让 调用 者 可 以 通过 提供 字符 串 
形式 的 错误 名 来 捕捉 (trap) 不 同 的 错误 。 


不 过 这 些 特性 用 得 并 不 多 ， 所 以 并 不 是 特别 重要 ， 一 个 受 限 的 (limited) 客户 端 可 以 通过 简 
单 地 返回 一 个 逻辑 假 (false) 来 表示 一 个 通用 的 错误 条 件 。 


整数 回复 
整数 回复 就 是 一 个 以 ":" FA, CRLF 结尾 的 字符 串 表 示 的 整数 。 
比如 说 ， ":0\r\n" 和 ":1000\r\n" 都 是 整数 回复 。 


返回 整数 回复 的 其 中 两 个 命令 是 INCR 和 LASTSAVE 。 被 返回 的 整数 没有 什么 特殊 的 含义 ， 
INCR 返回 键 的 一 个 自 增 后 的 整数 值 ， 而 LASTSAVE 则 返回 一 个 UNIX iB, 返回 值 的 唯 
一 限制 是 这 些 数 必须 能 够 用 64 位 有 符号 整数 表示 。 


整数 回复 也 被 广泛 地 用 于 表示 逻辑 真 和 逻辑 假 : 比如 EXISTS 和 SISMEMBER 都 用 返回 值 
1 表示 真 ， 6 表示 假 。 


其 他 一 些 命令 ， 比 如 SADD 、 SREM 和 SETNX , 只 在 操作 真正 被 执行 了 的 时 候 ， 才 返 回 
1, 否则 返回 o 。 


以 下 命 倒 都 返回 整数 回复 : SETNX 、 DEL, EXISTS, INCR, INCRBY, DECR, 
DECRBY 、DBSIZE 、LASTSAVE . RENAMENX 、MOVE 、LLEN 、 SADD 、 SREM 
、 SISMEMBER 、 SCARD, 


批量 回复 
服务 器 使 用 批量 回复 来 返回 二 进 制 安全 的 字符 串 ， 字 符 串 的 最 大 长 度 为 512 MB 。 


客户 端 : GET mykey 
服务 器 : foobar 


服务 器 发 送 的 内 容 中 : 


。 第 一 字 节 为 "8" 符号 

。 接 下 来 跟着 的 是 表示 实际 回复 长 度 的 数字 值 
。 之 后 跟着 一 个 CRLF 

٠ 再 后 面 跟着 的 是 实际 回复 数据 

。 最 末尾 是 另 一 个 CRLF 


对 于 前 面 的 GET 命令 ， 服 务 器 实际 发 送 的 内 容 为 : 


"$6\r\nfoobar\r\n" 


如 果 被 请 求 的 值 不 存在 ， 那么 批量 回复 会 将 特殊 值 -1 用 作 回 复 的 长 度 值 ， 就 像 这 样 : 


客户 端 : GET non-existing-key 
服务 器 : 5-1 


这 种 回复 称 为 空 批量 回复 (NULL Bulk Reply) 。 


当 请 求 对 象 不 存在 时 ， 客 户 端 应 该 返回 空 对 象 ， 而 不 是 空 字符 串 : 比如 Ruby 库 应 该 返回 
nil, MC 库 应 该 返回 we (或 者 在 回复 对 象 中 设置 一 个 特殊 标志 ) ， 诸如 此 类 。 


多 条 批量 回复 


像 LRANGE 这 样 的 命令 需要 返回 多 个 值 ， 这 一 目标 可 以 通过 多 条 批量 回复 来 完成 。 


多 条 批量 回复 是 由 多 个 回复 组 成 的 数组 ， 数组 中 的 每 个 元 素 都 可 以 是 任意 类 型 的 回复 ， 包括 
多 条 批量 回复 本 身 。 


多 条 批量 回复 的 第 一 个 字 节 为 "*" ， 后 跟 一 个 字符 串 表 示 的 整数 值 ， 这 个 值 记 录 了 多 条 批 
量 回复 所 包含 的 回复 数量 ， 再 后 面 是 一 个 CRLF 。 


客户 端 : LRANGE mylist 0 3 
* 
4 


服务 器 : 

服务 器 : $3 
服务 器 : foo 
服务 器 : $3 
服务 器 : bar 
服务 器 : $5 
服务 器 : Hello 
服务 器 : $5 


在 上 面 的 示例 中 ， 服 务 器 发 送 的 所 有 字符 串 都 由 CRLF 结尾 。 


正如 你 所 见 到 的 那样 ， 多 条 批量 回复 所 使 用 的 格式 ， 和 客户 端 发送 命 令 时 使 用 的 统一 请 求 协 
议 的 格式 一 模 一 样 。 它们 之 间 的 唯一 区 别 是 : 


。 统一 请 求 协议 只 发 送 批量 回复 。 
。 而 服务 器 应 答 命令 时 所 发 送 的 多 条 批量 回复 ， 则 可 以 包含 任意 类 型 的 回复 。 


以 下 例子 展示 了 一 个 多 条 批量 回复 ， 回复 中 包含 四 个 整数 值 ， 以 及 一 个 二 进 制 安全 字符 串 : 


*5\r\n 
:1NrxNn 
:2NrNn 
:3NrNn 
:4\r\n 
$6\r\n 
Foobar\r\n 


在 回复 的 第 一 行 ， 服务 器 发 送 *5\r\n , 表示 这 个 多 条 批量 回复 包含 5 条 回复 ， 再 后 面 跟 
着 的 则 是 5 条 回复 的 正文 。 
多 条 批量 回复 也 可 以 是 空白 的 (empty) ， 就 像 这 样 : 


客户 端 : LRANGE nokey © 1 
服务 器 : *O\r\n 


无 内 容 的 多 条 批量 回复 (null multi bulk reply) 也 是 存在 的 ， 比如 当 BLPOP 命令 的 阻塞 时 间 
超过 最 大 时 限时 ， 它 就 返回 一 个 无 内 容 的 多 条 批量 回复 ， 这 个 回复 的 计数 值 为 -1 


客户 端 : BLPOP key 1 
服务 器 : *-1\r\n 


客户 端 库 应 该 区 别 对 待 空 白 多 条 回复 和 无 内 容 多 条 回复 : 当 Redis 返回 一 个 无 内 容 多 条 回复 
at, 客户 端 库 应 该 返回 一 个 null 对 象 ， 而 不 是 一 个 空 数组 。 


多 条 批量 回复 中 的 空 元 素 


多 条 批量 回复 中 的 元 素 可 以 将 自身 的 长 度 设置 为 -1 ， 从 而 表示 该 元 素 不 存在 ， 并 且 也 不 是 
一 个 空白 字符 串 (empty string) 。 


“44 SORT 命令 使 用 Get pattern 选项 对 一 个 不 存在 的 键 进行 操作 时 ， 就 会 发 生 多 条 批量 回 
复 中 带 有 空白 元 素 的 情况 。 


以 下 例子 展示 了 一 个 包含 空 元 素 的 多 重 批量 回复 : 


服务 器 : *3 
服务 器 : $3 
服务 器 : foo 
服务 器 : $-1 
服务 器 : $3 
服务 器 : bar 


其 中 ， 回复 中 的 第 二 个 元 素 为 空 。 
对 于 这 个 回复 ， 客户 端 库 应 该 返回 类 似 于 这 样 的 回复 : 


["foo", nil, "bar"] 


多 命 信 和 流 LAK 2%, 
客户 端 可 以 通过 流水 线 ， 在 一 次 写 入 操作 中 发 送 多 个 命令 : 
。 在 发 送 新 命令 之 前 ， 无 须 阅读 前 一 个 命 合 的 回复 。 
。 多 个 命令 的 回复 会 在 最 后 一 并 返回 。 
ws 
A ak Op 


当 你 需要 和 Redis 服务 器 进行 沟通 ， 但 又 找 不 到 redis-cli ， 而 手 上 只 有 telnet 的 时 
候 ， 你 可 以 通过 Redis 特别 为 这 种 情形 而 设 的 内 联 命令 格式 来 发 送 命令 。 


以 下 是 一 个 客户 端 和 服务 器 使 用 内 联 命令 来 进行 交互 的 例子 


Z Pip: PING 
服务 器 : +PONG 


以 下 另 一 个 返回 整数 值 的 内 联 命令 的 例子 


客户 端 : EXISTS somekey 
服务 器 : :0 


因为 没有 了 统一 请 求 协议 中 的 "*" 项 来 声明 参数 的 数量 ， 所 以 在 telnet 会 话 输入 命令 的 
时 候 ， 必须 使 用 空格 来 分 割 各 个 参数 ， 服务 器 在 接收 到 数据 之 后 ， 会 按 空格 对 用 户 的 输入 进 
行 分 析 (parse), 并 获取 其 中 的 命令 参数 。 


Æ hH- اد‎ = so 

高 性 能 Redis 协议 分 析 器 

尽管 Redis 的 协议 非常 利于 人 类 阅读 ， 定义 也 很 简单 ， 但 这 个 协议 的 实现 性 能 仍然 可 以 和 二 
进 制 协议 一 样 快 。 

因为 Redis 协议 将 数据 的 长 度 放 在 数据 正文 之 前 ， 所 以 程序 无 须 像 JSON ABH, AT SHE 
个 特殊 字符 而 扫描 整个 payload ， 也 无 须 对 发 送 至 服务 器 的 payload 进行 转 义 (quote) 。 


程序 可 以 在 对 协议 文本 中 的 各 个 字符 进行 处 理 的 同时 ， 查找 CR 字符 ， 并 计算 出 批量 回复 或 
多 条 批量 回复 的 长 度 ， 就 像 这 样 : 


#include <stdio.h> 


int main(void) { 
unsigned char *p = "$123\r\n"; 
int len = 0; 


ptt; 

while(*p != '\r') { 
len = (len*10)+(*p - 'O'); 
ptt; 


/* Now p points at '\r', and the len is in bulk_len. */ 
printf("%d\n", len); 
return 0; 


得 到 了 批量 回复 或 多 条 批量 回复 的 长 度 之 后 ， 程序 只 需 调 用 一 次 _ read WR, 就 可 以 将 回复 
的 正文 数据 全 部 读 入 到 内 存 中 ， 而 无 须 对 这 些 数据 做 任何 的 处 理 。 


在 回复 最 末尾 的 CR 和 LF PRERE, REN 


Redis 协议 的 实现 性 能 可 以 和 二 进 制 协议 的 实现 性 能 相 媲 美 ， 并 且 由 于 Redis 协议 的 简单 
性 ， 大 部 分 高 级 语言 都 可 以 轻易 地 实现 这 个 协议 ， 这 使 得 客户 端 软件 的 bug 数量 大 大 减少 。 


持久 化 (persistence) 


Note 
本 文档 翻译 自 http://redis.io/topics/persistence 。 
这 篇 文章 提供 了 Redis 持久 化 的 技术 性 描述 ， 推荐 所 有 Redis 用 户 阅读 。 


要 更 广泛 地 了 解 Redis 持久 化 ， 以 及 这 种 持久 化 所 保证 的 耐久 性 (durability) ， 请 参考 文章 
Redis persistence demystified (PX) 。 


Redis 持久 化 


Redis 提供 了 多 种 不 同 级 别 的 持久 化 方式 : 


٠ RDB 持久 化 可 以 在 指定 的 时 间 间 隔 内 生成 数据 集 的 时 间 点 快照 (point-in-time 

snapshot) 。 

AOF 持久 化 记录 服务 器 执行 的 所 有 写 操 作 命令 ， 并 在 服务 器 启动 时 ， 通 过 重新 执行 这 些 
命令 来 还 原 数 据 集 。 AOF 文件 中 的 命令 全 部 以 Redis 协议 的 格式 来 保存 ， 新 命令 会 被 追 
加 到 文件 的 末尾 。 Redis 还 可 以 在 后 台 对 AOF 文件 进行 重 写 (rewrite) ， 使 得 AOF X 
件 的 体积 不 会 超出 保存 数据 集 状 态 所 需 的 实际 大 小 。 

Redis 还 可 以 同时 使 用 AOF 持久 化 和 RDB 持久 化 。 在 这 种 情况 下 ， 当 Redis 重启 时 ， 
它 会 优先 使 用 AOF 文件 来 还 原 数据 集 ， 因为 AOF 文件 保存 的 数据 集 通常 比 RDB 文件 
所 保存 的 数据 集 更 完整 。 

。 你 其 至 可 以 关闭 持久 化 功能 ， 让 数据 只 在 服务 器 运行 时 存在 。 


了 解 RDB 持久 化 和 AOF 持久 化 之 间 的 异同 是 非常 重要 的 ， 以 下 几 个 小 节 将 详细 地 介绍 这 这 
两 种 持久 化 功能 ， 并 对 它们 的 相同 和 不 同 之 处 进行 说 明 。 


RDB AiR 


。 RDB 是 一 个 非常 紧凑 (compact) 的 文件 ， 它 保存 了 Redis 在 某 个 时 间 点 上 的 数据 集 。 
这 种 文件 非常 适合 用 于 进行 各 份 : 比如 说 ， 你 可 以 在 最 近 的 24 小 时 内 ， 每 小 时 各 份 一 
次 RDB 文件 ， 并 且 在 每 个 月 的 每 一 天 ， 也 各 份 一 个 RDB 文件 。 这 样 的 话 ， 即 使 遇 上 问 
题 ， 也 可 以 随时 将 数据 集 还 原 到 不 同 的 版 本 。 

。 RDB 非常 适用 于 灾难 恢复 (disasterrecovery) : 它 只 有 一 个 文件 ， 并 且 内 容 都 非常 紧 
>, A (EWEA) 将 它 传送 到 别 的 数据 中 心 ， 或 者 亚马逊 53 中 。 

。 RDB 可 以 最 大 化 Redis 的 性 能 : 父 进程 在 保存 RDB 文件 时 唯一 要 做 的 就 是 fork 出 一 
个 子 进程 ， 然 后 这 个 子 进程 就 会 处 理 接 下 来 的 所 有 保存 工作 ， 父 进程 无 须 执 行 任何 磁盘 
IO 操作 。 


RDB 在 恢复 大 数据 集 时 的 速度 比 AOF 的 恢复 速度 要 快 。 


RDB 的 缺点 


如 果 你 需要 尽量 避免 在 服务 器 故障 时 丢失 数据 ， 那 么 RDB 不 适合 你 。 虽然 Redis 人 允许 
你 设置 不 同 的 保存 点 (save point) 来 控制 保存 RDB 文件 的 频率 ， 但 是 ， 因为 RDB 文 
件 需要 保存 整个 数据 集 的 状态 。 所 以 它 并 不 是 一 个 轻松 的 操作 。 因此 你 可 能 会 至 少 5 分 
钟 才 保 存 一 次 RDB 文件 。 在 这 种 情况 下 ， 一 旦 发 生 故障 停机 ， 你 就 可 能 会 丢失 好 几 分 
钟 的 数据 。 

每 次 保存 RDB 的 时 候 ，Redis 都 要 fork() 出 一 个 子 进程 ， 并 由 子 进程 来 进行 实际 的 持 
久 化 工作 。 在 数据 集 比 较 庞 大 时 ， forko 可 能 会 非常 耗 时 ， 造 成 服务 器 在 某 某 毫秒 内 
停止 处 理 客 户 端 ; 如 果 数 据 集 非常 巨大 ， 并 且 CPU 时 间 非 常 紧张 的 话 ， 那 么 这 种 停止 
时 间 甚 至 可 能 会 长 达 整 整 一 秒 。 虽然 AOF 重 写 也 需要 进行 fork) ， 但 无 论 AOF BS 
的 执行 间隔 有 多 长 ， 数 据 的 耐久 性 都 不 会 有 任何 损失 。 


AOF 的 优点 


使 用 AOF 持久 化 会 让 Redis 变 得 非常 耐久 (much more durable) : 你 可 以 设置 不 同 的 
fsync 策略 ， 上 比如 无 fsync ， 每 秒 钟 一 次 fsync ， 或 者 每 次 执行 写 人 命令 时 fsync 
。 AOF 的 默认 策略 为 每 秒 钟 fsync 一 次 ， 在 这 种 配置 下 ，Redis 仍然 可 以 保持 良好 的 
性 能 ， 并 且 就 算 发 生 故 障 停 机 ， 也 最 多 只 会 丢失 一 秒 钟 的 数据 ( fsync 会 在 后 台 线 程 执 
行 ， 所 以 主线 程 可 以 继续 努力 地 处 理 命 合 请 求 ) 。 

AOF 文件 是 一 个 只 进行 追加 操作 的 日 志文 件 (append only log) ， 因此 对 AOF 文件 的 
写 入 不 需要 进行 seek , 即使 日 志 因为 某 些 原因 而 包含 了 未 宇和 完整 的 命令 〈 比 如 写 入 
时 位 瘟 已 满 ， 写 入 中 途 停机 ， 等 等 ) ， redis-check-aof 工具 也 可 以 轻易 地 修复 这 种 问 
ei, 

Redis 可 以 在 AOF 文件 体积 变 得 过 大 时 ， 自 动 地 在 后 台 对 AOF 进行 重 写 : 重 写 后 的 新 
AOF 文件 包含 了 恢复 当前 数据 集 所 需 的 最 小 命令 集合 。 整个 重 写 操作 是 绝对 安全 的 ， 
为 Redis 在 创建 新 AOF 文件 的 过 程 中 ， 会 继续 将 命令 追加 到 现 有 的 AOF 文件 里 面 ， 即 
使 重 写 过 程 中 发 生 停机 ， 现 有 的 AOF 文件 也 不 会 去 失 。 而 一 旦 新 AOF 文件 创建 完毕 ， 
Redis 就 会 从 旧 AOF 文件 切换 到 新 AOF 文件 ， 并 开始 对 新 AOF 文件 进行 追加 操作 。 
AOF 文件 有 序 地 保存 了 对 数据 库 执 行 的 所 有 写 入 操作 ， 这 些 写 入 操作 以 Redis 协议 的 格 
式 保 存 ， 因此 AOF 文件 的 内 容 非常 容易 被 人 读 懂 ， 对 文件 进行 分 析 (parse) 也 很 轻 
松 。 tH (export) AOF 文件 也 非常 简单 : 举 个 例子 ， 如 果 你 不 小 心 执 行 了 
FLUSHALL AP, BRE AOF 文件 未 被 重 写 ， 那么 只 要 停止 服务 器 ， 移 除 AOF 文件 
末尾 的 FLUSHALL MS, 并 重启 Redis , 就 可 以 将 数据 集 恢复 到 FLUSHALL 执行 之 前 
的 状态 。 


AOF 的 缺点 


e 对 于 相同 的 数据 集 来 说 ，AOF 文件 的 体积 通常 要 大 于 RDB 文件 的 体积 。 

٠ 根据 所 使 用 的 fsync 策略 ，AOF 的 速度 可 能 会 慢 于 RDB. 在 一 般 情况 下 ， 每 秒 
fsync 的 性 能 依然 非常 高 ， 而 关闭 fsync 可 以 让 AOF 的 速度 和 RDB 一 样 快 ， 即使 
在 高 负荷 之 下 也 是 如 此 。 不 过 在 处 理 巨 大 的 写 入 载 入 时 ，RDB 可 以 提供 更 有 保证 的 最 大 
延迟 时 间 (latency) 。 

٠ AOF 在 过 去 便 经 发 生 过 这 样 的 bug : 因为 个 别 命令 的 原因 ， 导 臻 AOF 文件 在 重新 载 人 
时 ， 无 法 将 数据 集 恢复 成 保存 时 的 原样 。 【〈 举 个 例子 ， 阻 塞 命令 BRPOPLPUSH 就 佛经 
引起 过 这 样 的 bug 。) 测试 套件 里 为 这 种 情况 添加 了 测试 : 它们 会 自动 生成 随机 的 、 复 
杂 的 数据 集 ， 并 通过 重新 载 入 这 些 数 据 来 确保 一 切 正常 。 虽然 这 种 bug 在 AOF 文件 中 
并 不 常见 ， 但 是 对 比 来 说 ， RDB 几乎 是 不 可 能 出 现 这 种 bug AY. 


RDB 和 AOF ， 我 应 该 用 哪 一 个 ? 


一 般 来 说 ， 如 果 想 达到 足以 媲美 PostgreSQL 的 数据 安全 性 ， 你 应 该 同时 使 用 两 种 持久 化 功 


Ab 
BB o 


如 果 你 非常 关心 你 的 数据 ， 但 仍然 可 以 承受 数 分 钟 以 内 的 数据 丢失 ， 那么 你 可 以 只 使 用 
RDB 持久 化 。 


有 很 多 用 户 都 只 使 用 AOF 持久 化 ， 但 我 们 并 不 推荐 这 种 方式 : 因为 定时 生成 RDB 快照 
(snapshot) 非常 便于 进行 数据 库 各 份 ， 并 且 RDB 恢复 数据 集 的 速度 也 要 比 AOF 恢复 的 速 
度 要 快 ， 除 此 之 外 ， 使 用 RDB 还 可 以 避免 之 前 提 到 的 AOF 程序 的 bug o 


Note 


因为 以 上 提 到 的 种 种 原因 ， 未 来 我 们 可 能 会 业 AOF 和 RDB 整合 成 单个 持久 化 模型 。 (这 是 
一 个 长 期 计划 。) 


接 下 来 的 几 个 小 节 将 介绍 RDB 和 AOF 的 更 多 细节 。 


RDB 快照 


在 默认 情况 下 ， Redis 将 数据 库 快照 保存 在 名 字 为 dump.rdb 的 二 进 制 文件 中 。 


你 可 以 对 Redis 进行 设置 ， 让 它 在 ”N 秒 内 数据 集 至 少 有 n 个 改动 "这 一 条 件 被 满足 时 ， 
自动 保存 一 次 数据 集 。 


你 也 可 以 通过 调用 SAVE 或 者 BGSAVE ， 手动 让 Redis 进行 数据 集 保存 操作 。 


比如 说 ， 以 下 设置 会 让 Redis 在 满足 ” co 秒 内 有 至 少 有 1000 个 键 被 改动 ”这 一 条 件 时 ， 自 
动 保存 一 次 数据 集 : 


save 60 1000 


这 种 持久 化 方式 被 称 为 快照 (snapshot) 。 


快照 的 运作 方 却 


当 Redis 需要 保存 dump.rdb 文件 时 ， 服务 器 执行 以 下 操作 : 


1. Redis 调用 fork() ， 同 时 拥有 父 进 程 和 子 进程 。 

2.， 子 进程 将 数据 集 宇 人 到 一 个 临时 RDB 文件 中 。 

3， 当 子 进程 完成 对 新 RDB 文件 的 写 入 时 ，Redis 用 新 RDB 文件 替换 原来 的 RDB 文件 ， 并 
删除 旧 的 RDB 文件 。 


这 种 工作 方式 使 得 Redis 可 以 从 写 时 复制 (copy-on-write) 机 制 中 获 益 。 


只 进行 追加 操作 的 文件 (append-only file, AOF) 


快照 功能 并 不 是 非常 耐久 (durable) : 如 果 Redis 因为 某 些 原因 而 造成 故障 停机 ， 那么 服 
务 器 将 丢失 最 近 写 入 、 上 且 仍 未 保存 到 快照 中 的 那些 数据 。 


尽管 对 于 某 些 程序 来 说 ， 数据 的 耐久 性 并 不 是 最 重要 的 考虑 因素 ， 但 是 对 于 那些 追求 完全 耐 
AREA (full durability) 的 程序 来 说 ， 快照 功能 就 不 太 适 用 了 。 


M 1.1 版 本 开始 ， Redis 增加 了 一 种 完全 耐久 的 持久 化 方式 : AOF 持久 化 。 
你 可 以 通过 修改 配置 文件 来 打开 AOF 功能 : 


appendonly yes 


从 现在 开始 ， 每 当 Redis 执行 一 个 改变 数据 集 的 命令 时 (比如 SET) ， 这 个 命令 就 会 被 追加 
到 AOF 文件 的 末尾 。 


这 样 的 话 ， 当 Redis BAAN, 程序 就 可 以 通过 重新 执行 AOF 文件 中 的 命令 来 达到 重建 数 
据 集 的 目的 。 


AOF 5 
因为 AOF 的 运作 方式 是 不 断 地 将 命令 追加 到 文件 的 末尾 ， 所 以 随 着 写 和 命令 的 不 断 增 加 ， 
AOF 文件 的 体积 也 会 变 得 越 来 越 大 。 


举 个 例子 ， 如 果 你 对 一 个 计数 器 调用 了 100 次 INCR , 那么 仅仅 是 为 了 保存 这 个 计数 器 的 当 
前 值 ，AOF 文件 就 需要 使 用 100 条 记录 (entry) 。 


然而 在 实际 上 ， 只 使 用 一 条 SET 命令 已 经 足以 保存 计数 器 的 当前 值 了 ， 其 余 99 条 记录 实际 
上 都 是 多 余 的 。 


为 了 义理 这 种 情况 ， Redis 支持 一 种 有 趣 的 特性 : 可 以 在 不 打 断 服务 客户 端的 情况 下 ， 对 
AOF 文件 进行 重建 (rebuild) 。 


执行 BGREWRITEAOF AP, Redis 将 生成 一 个 新 的 AOF 文件 ， 这 个 文件 包含 重建 当前 数 
据 集 所 需 的 最 少 命令 。 


Redis 2.2 需要 自己 手动 执行 BGREWRITEAOF 命令 ; Redis 2.4 则 可 以 自动 触发 AOF Æ 
写 ， 具体 信息 请 查看 2.4 的 示例 配置 文件 。 


AOF 的 耐久 性 如 何 ? 


你 可 以 配置 Redis 多 久 才 将 数据 fsync 到 磁盘 一 次 。 
有 三 个 选项 : 


。 每 次 有 新 命令 追加 到 AOF 文件 时 就 执行 一 次 fsync : 非常 慢 ， 也 非常 安全 。 

٠ 每 秒 fsync 一 次 : 足够 快 (和 使 用 RDB 持久 化 差不多 ) ， 并 且 在 故障 时 只 会 丢失 1 秒 
钟 的 数据 。 

٠ 从 不 fsync : 将 数据 交 给 操作 系统 来 处 理 。 更 快 ， 也 更 不 安全 的 选择 。 


推荐 (并 且 也 是 默认 ) 的 措施 为 每 秒 fsync 一 次 ， 这 种 fsync 策略 可 以 兼顾 速度 和 安全 
性 。 


总 是 fsync 的 策略 在 实际 使 用 中 非常 慢 ， 即使 在 Redis 2.0 对 相关 的 程序 进行 了 改进 之 后 仍 
是 如 此 频繁 调用 fsync 注定 了 这 种 策略 不 可 能 快 得 起 来 。 





如 果 AOF 文件 出 错 了 ， 怎 么 办 ? 


服务 器 可 能 在 程序 正在 对 AOF 文件 进行 宇 入 时 停机 ， 如 果 停 机 造成 了 AOF 文件 出 错 
(corrupt) , 那么 Redis 在 重启 时 会 拒绝 载 和 这 个 AOF 文件 ， 从 而 确保 数据 的 一 致 性 不 会 
被 破坏 。 


当 发 生 这 种 情况 时 ， 可 以 用 以 下 方法 来 修复 出 错 的 AOF 文件 : 


1. 为 现 有 的 AOF 文件 创建 一 个 各 份 。 
2. 使 用 Redis 附带 的 redis-check-aof 程序 ， 对 原来 的 AOF 文件 进行 修复 。 


> &gt; $ redis-check-aof --fix :غ502‎ &gt; 


1. (可 选 ) 使 用 aiff -u 对 比 修复 后 的 AOF 文件 和 原始 AOF 文件 的 备份 ， 查 看 两 个 文件 
之 间 的 不 同 之 处 。 
2. 重启 Redis 服务 器 ， 等 待 服务 器 载 人 修复 后 的 AOF 文件 ， 并 进行 数据 恢复 。 


AOF 的 运作 方式 


AOF 重 写 和 RDB 创建 快照 一 样 ， 都 巧妙 地 利用 了 写 时 复制 机 制 。 
以 下 是 AOF 重 写 的 执行 步骤 : 


1. Redis 执行 fork() ， 现 在 同时 拥有 父 进程 和 子 进程 。 

2. 子 进程 开始 将 新 AOF 文件 的 内 容 写 入 到 临时 文件 。 

3， 对 于 所 有 新 执行 的 写 和 人 命令， 父 进程 一 边 将 它们 累积 到 一 个 内 存 缓存 中 ， 一 按 将 这 些 改 
动 追加 到 现 有 AOF 文件 的 末尾 : 这 样 即 使 在 重 写 的 中 途 发 生 停机 ， 现 有 的 AOF 文件 也 
还 是 安全 的 。 

4， 当 子 进 程 完成 重 写 工作 时 ， 它 给 父 进程 发 送 一 个 信号 ， 父 进程 在 接收 到 信和 号 之 后 ， 将 内 
存 缓存 中 的 所 有 数据 追加 到 新 AOF 文件 的 末尾 。 

5. 搞定 ! 现在 Redis 原子 地 用 新 文件 替换 旧 文 件 ， 之 后 所 有 命令 都 会 直接 追加 到 新 AOF 文 
件 的 末尾 。 


怎么 从 RDB 持久 化 切换 到 AOF 持久 化 


在 Redis 2.2 或 以 上 版 本 ， 可 以 在 不 重启 的 情况 下 ， 从 RDB 切换 到 AOF : 


1. 为 最 新 的 dump.rdb 文件 创建 一 个 备份 。 
2， 将 备份 放 到 一 个 安全 的 地 方 。 
3. 执行 以 下 两 条 命令 : 


> 
&gt; redis-cli&gt; CONFIG SET appendonly yes &gt; &gt; redis-cli&gt; CONFIG SET save "" 50 


1. 确保 命令 执行 之 后 ， 数 据 库 的 键 的 数量 没有 改变 。 
2， 确 保 写 命令 会 被 正确 地 追加 到 AOF 文件 的 末尾 。 


步骤 3 执行 的 第 一 条 命令 开启 了 AOF 功能 : Redis 会 阻塞 直到 初始 AOF 文件 创建 完成 为 
止 ， 之 后 Redis 会 继续 义理 命令 请 求 ， 并 开始 将 写 入 命令 追加 到 AOF 文件 末尾 。 


步骤 3 执行 的 第 二 条 命令 用 于 关闭 RDB 功能 。 这 一 步 是 可 选 的 ， 如 果 你 愿意 的 话 ， 也 可 以 
同时 使 用 RDB 和 AOF 这 两 种 持久 化 功能 。 


Note 


别 忘 了 在 redis.conf 中 打开 AOF 功能 ! 否则 的 话 ， 服务 器 重启 之 后 ， 之 前 通过 
CONFIG SET 设置 的 配置 就 会 被 遗忘 ， 程序 会 按 原来 的 配置 来 启动 服务 器 。 


Note 


译注 : 原文 这 里 还 有 介绍 2.0 版 本 的 切换 方式 ， 考虑 到 2.0 已 经 很 老 旧 了 ， 这 里 省 略 了 对 那 
部 分 文档 的 翻译 ， 有 需要 的 请 参考 原文 。 


RDB 和 AOF 之 间 的 相互 作用 


在 版 本 号 大 于 等 于 2.4 的 Redis رط‎ BGSAVE 执行 的 过 程 中 ， 不 可 以 执行 
BGREWRITEAOF 。 反 过 来 说 ， 在 BGREWRITEAOF 执行 的 过 程 中 ， 也 不 可 以 执行 
BGSAVE 。 


这 可 以 防止 两 个 Redis 后 台 进程 同时 对 磁盘 进行 大 量 的 1/O 操作 。 


如 果 BGSAVE 正在 执行 ， 并 且 用 户 显示 地 调用 BGREWRITEAOF 命令 ， 那么 服务 器 将 向 用 
户 回复 一 个 ok KA, 并 告知 用 户 ， BGREWRITEAOF 已 经 被 预定 执行 : 一 旦 BGSAVE 
执行 完毕 ， BGREWRITEAOF 就 会 正式 开始 。 


当 Redis 启动 时 ， 如 果 RDB 持久 化 和 AOF 持久 化 都 被 打开 了 ， 那么 程序 会 优先 使 用 AOF 
文件 来 恢复 数据 集 ， 因为 AOF 文件 所 保存 的 数据 通常 是 最 完整 的 。 


各 份 Redis 数据 


在 阅读 这 个 小 节 前 ， 先 将 下 面 这 句 话 铭 记 于 心 : 一 定 要 备份 你 的 数据 库 ! 


磁盘 故障 ， 节点 失效 ， 诸如 此 类 的 问题 都 可 能 让 你 的 数据 消失 不 见 ， 不 进行 备份 是 非常 危险 
的 。 


Redis 对 于 数据 各 份 是 非常 友好 的 ， 因为 你 可 以 在 服务 器 运行 的 时 候 对 RDB 文件 进行 复制 : 
RDB 文件 一 旦 被 创建 ， 就 不 会 进行 任何 修改 。 当 服 务 器 要 创建 一 个 新 的 RDB 文件 时 ， CH 
将 文件 的 内 容 保 存在 一 个 临时 文件 里 面 ， 当 临 时 文件 写 人 完毕 时 ， 程序 才 使 用 rename(2) 
原子 地 用 临时 文件 替换 原来 的 RDB 文件 。 


这 也 就 是 说 ， 无 论 何 时 ， 复制 RDB 文件 都 是 绝对 安全 的 。 
以 下 是 我 们 的 建议 : 


。 创建 一 个 定期 任务 (cron job) ， 每 小 时 将 一 个 RDB 文件 各 份 到 一 个 文件 夹 ， 并 且 每 天 
将 一 个 RDB 文件 备份 到 另 一 个 文件 夹 。 

。 确保 快照 的 备份 都 带 有 相应 的 日 期 和 时 间 人 信息， 每 次 执行 定期 任务 脚本 时 ， 使 用 find 

命令 来 删除 过 期 的 快照 : 比如 说 ， 你 可 以 保留 最 近 48 小 时 内 的 每 小 时 快照 ， 还 可 以 保 

留 最 近 一 两 个 月 的 每 日 快照 。 

至 少 每 天 一 次 ， 将 RDB 各 份 到 你 的 数据 中 心 之 外 ， 或 者 至 少 是 备份 到 你 运行 Redis AK 

务 器 的 物理 机 器 之 外 。 
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Redis 的 容 灾 各 份 基本 上 就 是 对 数据 进行 各 份 ， 并 将 这 些 各 份 传送 到 多 个 不 同 的 外 部 数据 中 
心 。 


容 灾 备份 可 以 在 Redis 运行 并 产生 快照 的 主 数据 中 心 发 生 严 重 的 问题 时 ， 仍然 让 数据 处 于 安 
全 状态 。 


因为 很 多 Redis 用 户 都 是 创业 者 ， 他 们 没有 大 把 大 把 的 钱 可 以 浪费 ， 所 以 下 面 介绍 的 都 是 一 
些 实用 又 便宜 的 容 灾 各 份 方法 : 
e Amazon 53 ， 以 及 其 他 类 似 53 的 服务 ， 是 一 个 构建 灾难 备份 系统 的 好 地 方 。 最 简单 的 
方法 就 是 将 你 的 每 小 时 或 者 每 日 RDB 备份 加 密 并 传送 到 S3 。 对 数据 的 加 密 可 以 通过 
ومو‎ -c 命令 来 完成 《对称 加 密 模 式 ) 。 记得 把 你 的 密码 放 到 几 个 不 同 的 、 安 全 的 地 方 
去 (比如 你 可 以 把 密码 复制 给 你 组 织 里 最 重要 的 人 物 ) 。 同时 使 用 多 个 储存 服务 来 保存 
数据 文件 ， 可 以 提升 数据 的 安全 性 。 
传送 快照 可 以 使 用 SCP 来 完成 (SSH 的 组 件 ) 。 以 下 是 简单 并 且 安 全 的 传送 方法 : 买 
一 个 离 你 的 数据 中 心 非常 远 的 VPS ， 装 上 SSH ， 创建 一 个 无 口令 的 SSH 客户 端 key 
， Fix key 添加 到 VPS 的 authorized_keys 文件 中 ， 这 样 就 可 以 向 这 个 VPS 传送 
快照 各 份 文件 了 。 为 了 达到 最 好 的 数据 安全 性 ， 至 少 要 从 两 个 不 同 的 提供 商 那里 各 购买 
— VPS 来 进行 数据 容 灾 各 份 。 


需要 注意 的 是 ， 这 类 容 灾 系 统 如 果 没 有 小 心地 进行 处 理 的 话 ， 是 很 容易 失效 的 。 


最 低 限度 下 ， 你 应 该 在 文件 传送 完毕 之 后 ， 检查 所 传送 备份 文件 的 体积 和 原始 快照 文件 的 体 
积 是 否 相 同 。 如 果 你 使 用 的 是 VPS , 那么 还 可 以 通过 上 比 对 文件 的 SHA1 校 验 和 来 确认 文件 


是 否 传送 完整 。 


另外 ， 你 还 需要 一 个 独立 的 警报 系统 ， 让 它 在 负责 传送 各 份 文件 的 传送 器 (transfer) KX 
时 通知 你 。 


Sentinel 


Note 
本 文档 翻译 自 : http://redis.io/topics/sentinel 。 


Redis 的 Sentinel 系统 用 于 管理 多 个 Redis 服务 器 (instance) , 该 系统 执行 以 下 三 个 任 
务 : 


e 监控 (Monitoring) : Sentinel 会 不 断 地 检查 你 的 主 服 务 器 和 从 服务 器 是 否 运 作 正 常 。 

。 提醒 (Notification) : 当 被 监控 的 某 个 Redis 服务 器 出 现 问题 时 ， Sentinel 可 以 通过 
API 向 管理 员 或 者 其 他 应 用 程序 发 送 通知 。 

自动 故障 迁移 (Automatic failover) : 当 一 个 主 服 务 器 不 能 正常 工作 时 ， Sentinel 会 
开始 一 次 自动 故障 迁移 操作 ， 它 会 将 失效 主 服务 器 的 其 中 一 个 从 服务 器 升级 为 新 的 主 服 
务 器 ， 并 让 失效 主 服务 器 的 其 他 从 服务 器 改 为 复制 新 的 主 服 务 器 ; 当 客 户 端 试 图 连接 失 
效 的 主 服务 器 时 ， 集群 也 会 向 客户 端 返 回 新 主 服务 器 的 地 址 ， 使 得 集群 可 以 使 用 新 主 服 
务 器 代替 失效 服务 器 。 


Redis Sentinel 是 一 个 分 布 式 系统 ， 你 可 以 在 一 个 架构 中 运行 多 个 Sentinel 进程 


(progress) ， 这 些 进程 使 用 流言 协议 (gossip protocols) 来 接收 关于 主 服 务 器 是 否 下 线 的 信 


息 ， 并 使 用 投票 协议 (agreement protocols) 来 决定 是 否 执行 自动 故障 迁移 ， 以 及 选择 哪个 


从 服务 器 作为 新 的 主 服务 器 。 


虽然 Redis Sentinel 释 出 为 一 个 单独 的 可 执行 文件 redis-sentinel , 但 实际 上 它 只 是 一 个 
运行 在 特殊 模式 下 的 Redis 服务 器 ， 你 可 以 在 启动 一 个 普通 Redis 服务 器 时 通过 给 定 
--sentinel 选项 来 启动 Redis Sentinel 。 


Warning 
Redis Sentinel 目前 仍 在 开发 中 ， 这 个 文档 的 内 容 可 能 随 着 Sentinel 实现 的 修改 而 变更 。 


Redis Sentinel 兼容 Redis 2.4.16 或 以 上 版 本 ， 推荐 使 用 Redis 2.8.0 或 以 上 的 版 本 。 


获取 Sentinel 

目前 Sentinel 系统 是 Redis 的 unstable 分 支 的 一 部 分 ， 你 必须 到 Redis 项 目的 Github 页 
面 克隆 一 份 unstable 分 值 ， 然后 通过 编译 来 获得 Sentinel 系统 。 

Sentinel 程序 可 以 在 编译 后 的 src 文档 中 发 现 ， 它 是 一 个 命名 为 redis-sentinel 的 程序 。 
你 也 可 以 通过 下 一 节 介 绍 的 方法 ， 让 redis-server 程序 运行 在 Sentinel 模式 之 下 。 


另外 ， 一 个 新 版 本 的 Sentinel 已 经 包含 在 了 Redis 2.8.0 版 本 的 释 出 文件 中 。 


启动 Sentinel 
对 于 redis-sentinel 程序 ， 你 可 以 用 以 下 命令 来 启动 Sentinel 系统 : 


redis-sentinel /path/to/sentinel.conf 


对 于 redis-server 程序 ， 你 可 以 用 以 下 命令 来 启动 一 个 运行 在 Sentinel 模式 下 的 Redis Ak 
务 器 : 


redis-server /path/to/sentinel.conf --sentinel 


两 种 方法 都 可 以 启动 一 个 Sentinel 实例 。 


启动 Sentinel 实例 必须 指定 相应 的 配置 文件 ， وو‎ 文件 来 保存 Sentinel 的 当前 状 
A, FE Sentinel 重启 时 通过 载 人 配置 文件 来 进行 状态 还 


WR EZ Sentinel 时 没有 指定 相应 的 配置 文件 ， 或 者 指定 的 配置 文件 不 可 写 (not 
writable) , 那么 Sentinel 会 拒绝 启动 。 


配置 Sentinel 


Redis 源码 中 包含 了 一 个 名 为 ”sentinel.conf 的 文件 ， 这 个 文件 是 一 个 带 有 详细 注释 的 
Sentinel 配置 文件 示例 。 


运行 一 个 Sentinel 所 需 的 最 少 配 置 如 下 所 示 : 


sentinel monitor mymaster 127.0.0.1 6379 2 
sentinel down-after-milliseconds mymaster 60000 
sentinel failover-timeout mymaster 180000 
sentinel parallel-syncs mymaster 1 


sentinel monitor resque 192.168.1.3 6380 4 
sentinel down-after-milliseconds resque 10000 
sentinel failover-timeout resque 180000 
sentinel parallel-syncs resque 5 


第 一 行 配置 指示 Sentinel 去 监视 一 个 名 为 mymaster MEARS SS, 这 个 主 服务 器 的 IP 地 址 
为 127.0.0.1 , 端口 号 为 6379 , 而 将 这 个 主 服务 器 判断 为 失效 至 少 需要 2 个 Sentinel 
同意 (只 要 同意 Sentinel 的 数量 不 达标 ， 自 动 故 障 迁 移 就 不 会 执行 ) 。 


不 过 要 注意 ， 无 论 你 设置 要 多 少 个 Sentinel 同意 才能 判断 一 个 服务 器 失效 ， 一 个 Sentinel 
都 需要 获得 系统 中 多 数 (majority) Sentinel 的 支持 ， 才能 发 起 一 次 自动 故障 迁移 ， 并 预 留 
一 个 给 定 的 配置 纪元 (configuration Epoch ， 一 个 配置 纪元 就 是 一 个 新 主 服务 器 配置 的 版 本 


号 ) 。 


换 句 话说 ， 在 只 有 少数 (minority) Sentinel 进程 正常 运作 的 情况 下 ， Sentinel 是 不 能 执 
行 自动 故障 迁移 的 。 


其 他 选项 的 基本 格式 如 下 : 


sentinel < 选项 的 名 字 > < 主 服务 器 的 名 字 > < 选项 的 值 > 


各 个 选项 的 功能 如 下 : 


down-after-milliseconds 选项 指定 了 Sentinel 认为 服务 器 已 经 断 线 所 需 的 宫 秒 数 。 


如 果 服 务 器 在 给 定 的 毫秒 数 之 内 ， 没有 返回 Sentinel 发 送 的 PING 命令 的 回复 ， 或 者 返 
回 一 个 错误 ， 那么 Sentinel 将 这 个 服务 器 标记 为 主观 下 线 (subjectively down, 简称 


SDOWN ) 。 


不 过 只 有 一 个 Sentinel 将 服务 器 标记 为 主观 下 线 并 不 一 定 会 引起 服务 器 的 自动 故障 迁 
B: 只 有 在 足够 数量 的 Sentinel 都 特 一 个 服务 器 标记 为 主观 下 线 之 后 ， 服务 器 才 会 被 标 
记 为 客观 下 线 (objectively down, 简称 opowN ( ， 这 时 自动 故障 迁移 才 会 执行 。 


将 服务 器 标记 为 客观 下 线 所 需 的 Sentinel 数量 由 对 主 服务 器 的 配置 决定 。 


parallel-syncs 选项 指定 了 在 执行 故障 转移 时 ， 最 多 可 以 有 多 少 个 从 服务 器 同时 对 新 的 
主 服务 器 进行 同步 ， 这 个 数字 越 小 ， 完成 故障 转移 所 需 的 时 间 就 越 长 。 


如 果 从 服务 器 被 设置 为 允许 使 用 过 期 数据 集 (参见 对 redis.conf 文件 中 对 
slave-serve-stale-data 选项 的 说 明 ) 0 那么 你 可 能 不 希望 所 有 从 服务 器 都 在 同一 时 间 
向 新 的 主 服务 器 发 送 同步 请 求 ， 因为 尽管 复制 过 程 的 绝 大 部 分 步骤 都 不 会 阻塞 从 服务 
器 ， 但 从 服务 器 在 载 和 人 主 服务 器 发 来 的 RDB 文件 时 ， 仍然 会 造成 从 服务 器 在 一 段 时 间 
内 不 能 义理 命令 请 求 : 如 果 全 部 从 服务 器 一 起 对 新 的 主 服务 器 进行 同步 ， 那么 就 可 能 会 
造成 所 有 从 服务 器 在 短 时 间 内 全 部 不 可 用 的 情况 出 现 。 

你 可 以 通过 将 这 个 值 设 为 1 来 保证 每 次 只 有 一 个 从 服务 器 处 于 不 能 处 理 命 合 请 求 的 状 
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本 文档 剩余 的 内 容 将 对 Sentinel 系统 的 其 他 选项 进行 介绍 ， 示例 配置 文件 sentinel.conf 也 
对 相关 的 选项 进行 了 完整 的 注释 。 


主观 下 线 和 客观 下 线 


前 面 说 过 ， Redis 的 Sentinel 中 关于 下 线 (down) 有 两 个 不 同 的 概念 : 


。 主观 下 线 (Subjectively Down, 简称 SDOWN) 指 的 是 单个 Sentinel 实例 对 服务 器 做 出 


的 下 线 判断 。 


٠ 客观 下 线 (Objectively Down, 简称 ODOWN) 指 的 是 多 个 Sentinel 实例 在 对 同一 个 服 


务 器 做 出 SDOWN 判断 ， 并 且 通 过 SENTINEL is-master-down-by-addr 命令 互相 交流 之 


后 ， 得 出 的 服务 器 下 线 判 断 。 “一 个 Sentinel 可 以 通过 向 另 一 个 Sentinel 发 送 
SENTINEL is-master-down-by-addr 命令 来 询问 对 方 是 否认 为 给 定 的 服务 器 已 下 线 。 ) 


如 果 一 个 服务 器 没有 在 master-down-after-milliseconds 选项 所 指定 的 时 间 内 ， 对 向 它 发 送 
PING 命令 的 Sentinel 返回 一 个 有 效 回 复 (valid reply) , 那么 Sentinel 就 会 将 这 个 服务 器 标 
记 为 主观 下 线 。 


服务 器 对 PING 命令 的 有 效 回复 可 以 是 以 下 三 种 回复 的 其 中 一 种 : 


e 返回 +PONG 。 
٠ 返回 -LOADING 错误 。 


e 返回 -MASTERDOWN 错误 。 


如 果 服 务 器 返回 除 以 上 三 种 回复 之 外 的 其 他 回复 ， 又 或 者 在 指定 时 间 内 没有 回复 PING 命 
D, 那么 Sentinel 认为 服务 器 返回 的 回复 无 效 (non-valid) 。 


注意 ， 一 个 服务 器 必须 在 master-down-after-milliseconds S2YA, 一 直 返 回 无 效 回复 才 会 
被 Sentinel 标记 为 主观 下 线 。 


举 个 例子 ， 如 果 master-down-after-milliseconds 选项 的 值 为 30000 =F) ( 30 秒 ) 0 那 
么 只 要 服务 器 能 在 每 29 秒 之 内 返回 至 少 一 次 有 效 回复 ， 这 个 服务 器 就 仍然 会 被 认为 是 处 于 
正常 状态 的 。 


从 主观 下 线 状态 切换 到 客观 下 线 状态 并 没有 使 用 严格 的 法 定 人 数 算法 (strong quorum 
algorithm) , 而 是 使 用 了 流言 协议 : 如 果 Sentinel 在 给 定 的 时 间 范 围 内 ， 从 其 他 Sentinel 
那里 接收 到 了 足够 数量 的 主 服 务 器 下 线 报告 ， 那么 Sentinel 就 会 将 主 服务 器 的 状态 从 主观 下 
线 改 变 为 客观 下 线 。 如 果 之 后 其 他 Sentinel 不 再 报告 主 服 务 器 已 下 线 ， 那么 客观 下 线 状态 就 
会 被 移 除 。 


客观 下 线条 件 只 适用 于 主 服 务 器 : 对 于 任何 其 他 类 型 的 Redis 实例 ， Sentinel 在 将 它们 判断 
为 下 线 前 不 需要 进行 协商 ， 所 以 从 服务 器 或 者 其 他 Sentinel 永远 不 会 达到 客观 下 线条 件 。 


只 要 一 个 Sentinel 发 现 某 个 主 服务 器 进入 了 客观 下 线 状态 ， 这 个 Sentinel 就 可 能 会 被 其 他 
Sentinel 推选 出 ， 并 对 失效 的 主 服务 器 执行 自动 故障 迁移 操作 。 


每 个 Sentinel 都 需要 定期 执行 的 任务 


。 每 个 Sentinel 以 每 秒 钟 一 次 的 频率 向 它 所 知 的 主 服务 器 、 从 服务 器 以 及 其 他 Sentinel 实 
例 发 送 一 个 PING 命令 。 

٠ 如 果 一 个 实例 (instance) 距离 最 后 一 次 有 效 回复 PING 命令 的 时 间 超过 
down-after-milliseconds 选项 所 指定 的 值 ， 那么 这 个 实例 会 被 Sentinel 标记 为 主观 下 
线 。 一 个 有 效 回复 可 以 是 : +PONG 、 -LOADING 或 者 -MASTERDOWN o 

٠ 如 果 一 个 主 服 务 器 被 标记 为 主观 下 线 ， 那么 正在 监视 这 个 主 服务 器 的 所 有 Sentinel 要 以 
每 秒 一 次 的 频率 确认 主 服务 器 的 确 进 入 了 主观 下 线 状态 。 


٠ 如 果 一 个 主 服务 器 被 标记 为 主观 下 线 ， 并 且 有 足够 数量 的 Sentinel (至 少 要 达到 配置 文 
件 指定 的 数量 ) 在 指定 的 时 间 范 围 内 同意 这 一 判断 ， 那么 这 个 主 服务 器 被 标记 为 客观 下 
线 。 

٠ 在 一 般 情 况 下 ， 每 个 Sentinel 会 以 每 10 秒 一 次 的 频率 向 它 已 知 的 所 有 主 服务 器 和 从 服 
务 器 发 送 INFO 命令 。 当 一 个 主 服 务 器 被 Sentinel 标记 为 客观 下 线 时 ， Sentinel 向 下 线 
主 服务 器 的 所 有 从 服务 器 发 送 INFO 命令 的 频率 会 从 10 秒 一 次 改 为 每 秒 一 次 。 

。 当 没 有 足够 数量 的 Sentinel 同意 主 服 务 器 已 经 下 线 ， 主 服务 器 的 客观 下 线 状 态 就 会 被 移 
除 。 当主 服务 器 重新 向 Sentinel 的 PING 命令 返回 有 效 回复 时 ， 主 服务 器 的 主管 下 线 状 
态 就 会 被 移 除 。 


自动 发 现 Sentinel 和 从 服务 器 


一 个 Sentinel 可 以 与 其 他 多 个 Sentinel 进行 连接 ， 各 个 Sentinel 之 间 可 以 互相 检查 对 方 的 可 
用 性 ， 并 进行 信息 交换 。 


你 无 须 为 运行 的 每 个 Sentinel 分 别 设置 其 他 Sentinel 的 地 址 ， 因为 Sentinel 可 以 通过 发 布 与 
订阅 功能 来 自动 发 现 正 在 监视 相同 主 服务 器 的 其 他 Sentinel, 这 一 功能 是 通过 向 频道 
sentinel :hello 发 送 = RSE oN. 


与 此 类 似 ， 你 也 不 必 手 动 列 出 主 服 务 器 属 下 的 所 有 从 服务 器 ， 因为 Sentinel 可 以 通过 询问 主 
服务 器 来 获得 所 有 从 服务 器 的 信息 。 


٠ 每 个 Sentinel 会 以 每 两 秒 一 次 的 频率 ， 通过 发 布 与 订阅 功能 ， 向 被 它 监视 的 所 有 主 服务 
器 和 从 服务 器 的 sentinel_ :hello 频道 发 送 一 条 信息 ， 信息 中 包含 了 Sentinel 的 IP 
地 址 、 端 口号 和 运行 ID (runid) 。 

e A Sentinel 都 订阅 了 被 它 监视 的 所 有 主 服 务 器 和 从 服务 器 的 sentinel_:hello 频 
道 ， 查找 之 前 未 出 现 过 的 sentinel (looking for unknown sentinels) 。 当 一 个 Sentinel 
发 现 一 个 新 的 Sentinel t, 它 会 将 新 的 Sentinel 添加 到 一 个 列表 中 ， 这 个 列表 保存 了 
Sentinel 已 知 的 ， 监视 同一 个 主 服 务 器 的 所 有 其 他 Sentinel 。 

e Sentinel 发 送 的 信息 中 还 包括 完整 的 主 服务 器 当前 配置 (configuration) 。 如 果 一 个 
Sentinel 包含 的 主 服 务 器 配置 比 另 一 个 Sentinel 发 送 的 配置 要 旧 ， 那么 这 个 Sentinel 会 
立即 升级 到 新 配置 上 。 

。 在 将 一 个 新 Sentinel 添加 到 监视 主 服务 器 的 列表 上 面 之 前 ， Sentinel 会 先 检查 列表 中 是 
否 已 经 包含 了 和 要 添加 的 Sentinel 拥有 相同 运行 ID 或 者 相同 地 址 (包括 IP 地 址 和 端口 
رك‎ Sentinel, 如 果 是 的 话 ， Sentinel 会 先 移 除 列表 中 已 有 的 那些 拥有 相同 运行 ID 
或 者 相同 地 址 的 Sentinel ， 然后 再 添加 新 Sentinel 。 


Sentinel API 


在 默认 情况 下 ， Sentinel 使 用 TCP 端口 26379 (普通 Redis 服务 器 使 用 的 是 6379 ) 。 


Sentinel 接受 Redis 协议 格式 的 命令 请 求 ， 所 以 你 可 以 使 用 redis-cli 或 者 任何 其 他 Redis 
客户 端 来 与 Sentinel 进行 通讯 。 
有 两 种 方式 可 以 和 Sentinel 进行 通讯 : 
。 第 一 种 方法 是 通过 直接 发 送 命令 来 查询 被 监视 Redis 服务 器 的 当前 状态 ， 以 及 Sentinel 
所 知道 的 关于 其 他 Sentinel 的 信息 ， 诸如 此 类 。 
٠ 另 一 种 方法 是 使 用 发 布 与 订阅 功能 ， 通过 接收 Sentinel 发 送 的 通知 : 当 执 行 故障 转移 操 
VE, 或 者 某 个 被 监视 的 服务 器 被 判断 为 主观 下 线 或 者 客观 下 线 时 ， Sentinel 就 会 发 送 相 
应 的 信息 。 


Sentinel #74 


以 下 列 出 的 是 Sentinel 接受 的 命令 : 


e PING : 返回 Ponc o 
è SENTINEL masters : 列 出 所 有 被 监视 的 主 服务 器 ， 以 及 这 些 主 服务 器 的 当前 状态 。 
© SENTINEL slaves &lt;master name&gt; : 列 出 给 定 主 服务 器 的 所 有 从 服务 器 ， 以 及 这 些 从 


服务 器 的 当前 状态 。 
© SENTINEL get-master-addr-by-name &lt;master name&gt; : 返回 给 定名 字 的 主 服 务 器 的 


IP 地 址 和 端口 号 。 如 果 这 个 主 服务 器 正在 执行 故障 转移 操作 ， 或 者 针对 这 个 主 服务 器 的 
故障 转移 操作 已 经 完成 ， 那么 这 个 命令 返回 新 的 主 服务 器 的 IP 地 址 和 端口 号 。 

٠ SENTINEL reset &lt;patternaégt; : 重 置 所 有 名 字 和 给 定 模 式 pattern 相 匹 配 的 主 服务 
器 。 pattern 参数 是 一 个 Glob 风格 的 模式 。 重 置 操作 清除 主 服务 器 目前 的 所 有 状态 ， 
包括 正在 执行 中 的 故障 转移 ， 并 移 除 目前 已 经 发 现 和 关联 的 ， 主 服务 器 的 所 有 从 服务 器 
和 Sentinel 。 

© SENTINEL failover &lt;master nameagt; : 当主 服务 器 失效 时 ， 在 不 询问 其 他 Sentinel 
意见 的 情况 下 ， 强制 开始 一 次 自动 故障 迁移 (不 过 发 起 故障 转移 的 Sentinel 会 向 其 他 
Sentinel 发 送 一 个 新 的 配置 ， 其 他 Sentinel 会 根据 这 个 配置 进行 相应 的 更 新 ) 。 


发 布 与 订阅 信息 


客户 端 可 以 将 Sentinel 看 作 是 一 个 只 提供 了 订阅 功能 的 Redis 服务 器 : 你 不 可 以 使 用 
PUBLISH 命令 向 这 个 服务 器 发 送信 息 ， 但 你 可 以 用 SUBSCRIBE 命令 或 者 PSUBSCRIBE 
命令 ， 通 过 订阅 给 定 的 频道 来 获取 相应 的 事件 提醒 。 


一 个 频道 能 够 接收 和 这 个 频道 的 名 字 相 同 的 事件 。 比如 说 ， 名 为 +sdown 的 频道 就 可 以 接收 
所 有 实例 进入 主观 下 线 (SDOWN) 状态 的 事件 。 


通过 执行 psusscrise * 命令 可 以 接收 所 有 事件 信息 。 


以 下 列 出 的 是 客户 端 可 以 通过 订阅 来 获得 的 频道 和 信息 的 格式 : 第 一 个 英文 单词 是 频道 /事件 
的 名 字 ， 其 余 的 是 数据 的 格式 。 


ae 当 格 式 中 包含 instance details 字样 时 ， 表示 频道 所 返回 的 信息 中 包含 了 以 下 用 于 
识别 目标 实例 的 内 容 : 


<instance-type> <name> <ip> <port> @ <master-name> <master-ip> <master-port> 


@ 字符 之 后 的 内 容 用 于 指定 主 服务 器 ， 这 些 内 容 是 可 选 的 ， 它们 仅 在 @ 字符 之 前 的 内 容 
指定 的 实例 不 是 主 服 务 器 时 使 用 。 


© +reset-master &lt;instance details&gt; : 主 服务 器 已 被 重 置 。 

e +slave &lt;instance details&gt; : 一 个 新 的 从 服务 器 已 经 被 Sentinel 识别 并 关联 。 

© +failover-state-reconf-slaves &lt;instance details&gt; : 故障 转移 状态 切换 到 了 
reconf-slaves 状态 。 

e +failover-detected &lt;instance details&gt; : 另 一 个 Sentinel 开始 了 一 次 故障 转移 操 
作 ， 或 者 一 个 从 服务 器 转换 成 了 主 服务 器 。 

e +slave-reconf-sent &lt;instance details&gt; : 领头 (leader) 的 Sentinel 向 实例 发 送 


了 SLAVEOF 命 舍 ， 为 实例 设置 新 的 主 服务 器 。 

© +slave-reconf-inprog &lt;instance details&gt; : 实例 正在 将 自己 设置 为 指定 主 服务 器 
的 从 服务 器 ， 但 相应 的 同步 过 程 仍 未 完成 。 

© +slave-reconf-done &lt;instance details&gt; : 从 服务 器 已 经 成 功 完 成 对 新 主 服务 器 的 
同步 。 





e -dup-sentinel &lt;instance details&gt; : ae A مار بي‎ 监视 的 一 个 或 多 个 
Sentinel 已 经 因为 重复 出 现 而 被 移 除 上 重启 的 时 候 ， 就 会 出 现 这 种 情 
况 。 

e +sentinel &lt;instance details&gt; : 一 个 监视 给 定 主 服务 器 的 新 Sentinel 已 经 被 识别 
并 添加 。 

e +sdown &lt;instance detailsé&gt; 给 定 的 实例 现在 处 于 主观 下 线 状 态 

e -sdown &lt;instance details&gt; 给 定 的 实例 已 ع ب تير‎ 

© +odown &lt;instance details&gt; 给 定 的 实例 现在 处 于 客观 下 线 状 态 

© -odown &lt;instance details&gt; 给 定 的 实例 ce ARBRE ا ع و‎ 

e +new-epoch &lt;instance detailsagt; : 当前 的 纪元 (epoch) 22 3 被 更 新 。 

© +try-failover &lt;instance details&gt; : 一 个 新 的 故障 迁移 操 作 正 在 执行 JH, 等 待 被 
大 多 数 Sentinel 选中 (waiting to be elected by the majority) 。 

e +elected-leader &lt;instance detailsagt; : 赢得 指定 纪元 的 选举 ， 可 以 进行 故障 迁移 
操作 了 。 

© +failover-state-select-slave &lt;instance details&gt; : 故障 转移 操 作 现 在 处 于 


select-slave KA — Sentinel 正在 寻找 可 以 升级 为 主 服务 器 的 从 服务 器 。 

e no-good-slave &lt;instance detailsagt; : Sentinel 操作 未 能 找到 适合 进行 升级 的 从 服 
务 器 。Sentinel 会 在 一 段 时 间 之 后 再 次 尝试 寻找 合适 的 从 服务 器 来 进行 升级 ， 又 或 者 直接 
放弃 执行 故障 转移 操作 。 

e selected-slave &lt;instance detailsagt; : Sentinel 顺利 找到 适合 进行 升级 的 从 服务 
Zro 


© failover-state-send-slaveof-noone &lt;instance details&gt; : Sentinel 正在 将 指定 的 
从 服务 器 升级 为 主 服务 器 ， 等 待 升级 功能 完成 。 

© failover-end-for-timeout &lt;instance details&gt; : 故障 转移 因为 超时 而 中 止 ， 不 过 
最 终 所 有 从 服务 器 都 会 开始 复制 新 的 主 服务 器 (slaves will eventually be configured to 
replicate with the new master anyway) 。 

© failover-end &lt;instance details&gt; : 故障 转移 操作 顺利 完成 。 所 有 从 服务 器 都 开始 
复制 新 的 主 服务 器 了 。 

© +switch-master &lt;master name&gt; &lt;oldip&gt; &lt;oldport&gt; &lt;newip&gt; &lt;nen 
: 配置 变更 ， 主 服务 器 的 IP 和 地 址 已 经 改变 。 这 是 绝 大 多 数 外 部 用 户 都 关心 的 信息 。 

e stilt : BEA tilt 模式 。 

e -tilt GRH tilt 模式 。 


故障 转移 


一 次 故障 转移 操作 由 以 下 步骤 组 成 : 
٠ 发 现 主 服务 器 已 经 进入 客观 下 线 状态 。 


٠ 对 我 们 的 当前 纪元 进行 自 增 (详情 请 参考 Raft leader election) , 并 尝试 在 这 个 纪元 中 
٠ 如 果 当 选 失败 ， 那么 在 设 定 的 故障 迁移 超时 时 间 的 两 倍 之 后 ， 重新 尝试 当选 。 如 果 当 选 


MI, 那么 执行 以 下 步骤 。 

e 选 出 一 个 从 服务 器 ， 并 将 它 升 级 为 主 服务 器 。 

。 向 被 选中 的 从 服务 器 发 送 SLAVEOF No onE 命令 ， 让 它 转变 为 主 服 务 器 。 

。 通过 发 布 与 订阅 功能 ， 将 更 新 后 的 配置 传播 给 所 有 其 他 Sentinel ， 其 他 Sentinel 对 它们 
自己 的 配置 进行 更 新 。 

。 向 已 下 线 主 服务 器 的 从 服务 器 发 送 SLAVEOF 命令 ， 让 它们 去 复制 新 的 主 服务 器 。 

当 所 有 从 服务 器 都 已 经 开始 复制 新 的 主 服务 器 时 ， 领头 Sentinel 终止 这 次 故障 迁移 操 

作 。 


Note 


每 当 一 个 Redis 实例 被 重新 配置 (reconfigured) 无 论 是 被 设置 成 主 服务 器 、 从 服务 
器 、 又 或 者 被 设置 成 其 他 主 服务 器 的 从 服务 器 —— Sentinel 都 会 向 被 重新 配置 的 实例 发 送 一 
个 CONFIG REWRITE MPD, 从 而 确保 这 些 配 置 会 持久 化 在 硬盘 里 。 





Sentinel 使 用 以 下 规则 来 选择 新 的 主 服务 器 : 


。 在 失效 主 服 务 器 属 下 的 从 服务 器 当中 ， 那些 被 标记 为 主观 下 线 、 已 断 线 、 或 者 最 后 一 次 
回复 PING 命令 的 时 间 大 于 五 秒 钟 的 从 服务 器 都 会 被 淘汰 。 

。 在 失效 主 服务 器 属 下 的 从 服务 器 当中 ， 那些 与 失效 主 服 务 器 连接 断 开 的 时 长 超过 
down-after 选项 指定 的 时 长 十 倍 的 从 服务 器 都 会 被 淘汰 。 

。 在 经 历 了 以 上 两 轮 淘汰 之 后 剩 下 来 的 从 服务 器 中 ， 我 们 选 出 复制 偏 移 量 (replication 


offset) 最 大 的 那个 从 服务 器 作为 新 的 主 服务 器 ; 如 果 复制 偏 移 量 不 可 用 ， 或 者 从 服务 
器 的 复制 偏 移 量 相同 ， 那么 带 有 最 小 运行 ID 的 那个 从 服务 器 成 为 新 的 主 服 务 器 。 


Sentinel 自动 故障 迁移 的 一 致 性 特质 


Sentinel 自动 故障 迁移 使 用 Raft 算法 来 选举 领头 (leader) Sentinel, 从 而 确保 在 一 个 给 定 
的 纪元 (epoch) 里 ， 只 有 一 个 领头 产生 。 

这 表示 在 同一 个 纪元 中 ， 不 会 有 两 个 Sentinel 同时 被 选中 为 领头 ， 并 且 各 个 Sentinel 在 同一 
个 纪元 中 只 会 对 一 个 领头 进行 投票 。 

更 高 的 配置 纪元 总 是 优 于 较 低 的 纪元 ， 因此 每 个 Sentinel 都 会 主动 使 用 更 新 的 纪元 来 代替 自 
己 的 配置 。 

简单 来 说 ， 我 们 可 以 将 Sentinel 配置 看 作 是 一 个 带 有 版 本 号 的 状态 。 一 个 状态 会 以 最 后 写 入 
者 胜出 (last-write-wins) 的 方式 〈 也 即 是 ， 最 新 的 配置 总 是 胜出 ) 传播 至 所 有 其 他 Sentinel 


o 


举 个 例子 ， 当 出 现 网 络 分 割 (network partitions) x, 一 个 Sentinel 可 能 会 包含 了 较 旧 的 配 
E, 而 当 这 个 Sentinel 接 到 其 他 Sentinel 发 来 的 版 本 更 新 的 配置 时 ， Sentinel 就 会 对 自己 的 
配置 进行 更 新 。 


如 果 要 在 网 络 分 割 出 现 的 情况 下 仍然 保持 一 致 性 ， 那么 应 该 使 用 min-slaves-to-write 选 
项 ， 让 主 服务 器 在 连接 的 从 实例 少 于 给 定数 量 时 停止 执行 写 操 作 ， 与 此 同时 ， 应 该 在 每 个 运 
行 Redis 主 服务 器 或 从 服务 器 的 机 器 上 运行 Redis Sentinel 进程 。 


Sentinel 状态 的 持久 化 


Sentinel 的 状态 会 被 持久 化 在 Sentinel 配置 文件 里 面 。 


每 当 Sentinel 接收 到 一 个 新 的 配置 ， 或 者 当 领 头 Sentinel 为 主 服务 器 创建 一 个 新 的 配置 时 ， 
这 个 配置 会 与 配置 纪元 一 起 被 保存 到 磁盘 里 面 。 


这 意味 着 停止 和 重启 Sentinel 进程 都 是 安全 的 。 


Sentinel 在 非 故 降 迁 移 的 情况 下 对 实例 进行 重新 配置 


即使 没有 自动 故障 迁移 操作 在 进行 ， Sentinel 总 会 尝试 业 当前 的 配置 设置 到 被 监视 的 实例 上 
面 。 特别 是 : 


。 根据 当前 的 配置 ， 如 果 一 个 从 服务 器 被 宣告 为 主 服务 器 ， 那么 它 会 代替 原 有 的 主 服务 
器 ， 成 为 新 的 主 服务 器 ， 并 且 成 为 原 有 主 服务 器 的 所 有 从 服务 器 的 复制 对 象 。 

。 那些 连接 了 错误 主 服务 器 的 从 服务 器 会 被 重新 配置 ， 使 得 这 些 从 服务 器 会 去 复制 正确 的 
主 服务 器 。 


Rit, 在 以 上 这 些 条 件 满 足 之 后 ， Sentinel 在 对 实例 进行 重新 配置 之 前 仍然 会 等 待 一 段 足 够 
长 的 时 间 ， 确保 可 以 接收 到 其 他 Sentinel 发 来 的 配置 更 新 ， 从 而 避免 自身 因为 保存 了 过 期 的 
配置 而 对 实例 进行 了 不 必要 的 重新 配置 。 


TILT 模式 


Redis Sentinel 严重 依赖 计算 机 的 时 间 功 能 : 比如 说 ， 为 了 判断 一 个 实例 是 否 可 用 ， 
Sentinel 会 记录 这 个 实例 最 后 一 次 相应 PING 命令 的 时 间 ， 并 将 这 个 时 间 和 当前 时 间 进 行 对 
比 ， 从 而 知道 这 个 实例 有 多 长 时 间 没 有 和 Sentinel 进行 任何 成 功 通讯 。 


不 过 ， 一 旦 计算 机 的 时 间 功 能 出 现 故 障 ， 或 者 计算 机 非常 忙 人 入， 又 或 者 进程 因为 某 些 原因 而 
被 阻塞 时 ， Sentinel 可 能 也 会 跟着 出 现 故障 。 


TILT 模式 是 一 种 特殊 的 保护 模式 : 当 Sentinel 发 现 系 统 有 些 不 对 劲 时 ， Sentinel 就 会 进入 
TILT 模式 。 


因为 Sentinel 的 时 间 中 断 器 默认 每 秒 执行 10 次 ， 所 以 我 们 预期 时 间 中 断 器 的 两 次 执行 之 间 
的 间隔 为 100 BHAA. Sentinel 的 做 法 是 ， 记录 上 一 次 时 间 中 断 器 执行 时 的 时 间 ， 并 将 
它 和 这 一 次 时 间 中 断 器 执行 的 时 间 进 行 对 比 : 


٠ 如 果 两 次 调用 时 间 之 间 的 差距 为 负 值 ， 或 者 非常 大 (超过 2 W), 那么 Sentinel 进入 
TILT 模式 。 
٠ 如 果 Sentinel 已 经 进入 TILT 模式 ， 那么 Sentinel 延迟 退出 TILT 模式 的 时 间 。 


当 Sentinel 进入 TILT 模式 时 ， 它 仍 然 会 继续 监视 所 有 目标 ， 但 是 : 


。 它 不 再 执行 任何 操作 ， 比 如 故障 转移 。 
e 当 有 实例 向 这 个 Sentinel 发 送 SENTINEL is-master-down-by-addr 命令 时 ， Sentinel 返回 
负 值 : 因为 这 个 Sentinel 所 进行 的 下 线 判 断 已 经 不 再 准确 。 


如 果 TILT 可 以 正常 维持 30 秒 钟 ， 那么 Sentinel 退出 TILT 模式 。 


义理 -BUSY 状态 

Warning 

该 功能 尚未 实现 

当 Lua 脚本 的 运行 时 间 超 过 指定 时 限时 ， Redis 就 会 返回 -Busy 错误 。 


当 出 现 这 种 情况 时 ， Sentinel 在 尝试 执行 故障 转移 操作 之 前 ， 会 先 向 服务 器 发 送 一 个 
SCRIPT KILL AS, 如 果 服 务 器 正在 执行 的 是 一 个 只 读 脚本 的 话 ， 那么 这 个 脚本 就 会 被 杀 
死 ， 服务 器 就 会 回 到 正常 状态 。 


Sentinel HJE P im £ I 


关于 Sentinel 客户 端的 实现 信息 可 以 参考 Sentinel 客户 端 指引 手册 。 


集群 教程 


Note 
本 文档 翻译 自 http://redis.io/topics/cluster-tutorial 。 
本 文档 是 Redis 集群 的 入 门 教程 ， 从 用 户 的 角度 介绍 了 设置 、 测 试 和 操作 集群 的 方法 。 


本 教程 不 包含 星 涩 难 懂 的 分 布 式 概念 ， 也 没有 像 Redis 集群 规范 那样 包含 Redis 集群 的 实现 
细节 ， 如 果 你 打算 深入 地 学 习 Redis 集群 的 部 署 方法 ， 那么 推荐 你 在 阅读 完 这 个 教程 之 后 ， 
再 去 看 一 看 集群 规范 。 


Redis 集群 目前 仍 处 于 Alpha 测试 版 本 ， 如 果 在 使 用 过 程 中 发 现任 何 问题 ， 请 到 Redis 的 
邮件 列表 Bat, 或 者 到 Redis 的 Github nM 报告 错误 。 


集群 简介 
Redis 集群 是 一 个 可 以 在 多 个 Redis 节点 之 间 进 行 数据 共享 的 设施 (installation) 。 


Redis 集群 不 支持 那些 需要 同时 义理 多 个 键 的 Redis 命令 ， 因 为 执行 这 些 命 令 需 要 在 多 
Redis 节点 之 间 移 动 数 据 ， 并 且 在 高 负载 的 情况 下 ， 这 些 命令 将 降低 Redis 集群 的 性 能 ， 并 
导致 不 可 预测 的 行为 。 


Redis 集群 通过 分 区 (partition) 来 提供 一 定 程度 的 可 用 性 (availability) : 即使 集群 中 有 一 
部 分 节点 失效 或 者 无 法 进行 通讯 ， 集群 也 可 以 继续 处 理 命 合 请 求 。 


Redis 集群 提供 了 以 下 两 个 好 处 : 


。 将 数据 自动 切 分 (split) 到 多 个 节点 的 能 力 。 
© 当 集 群 中 的 一 部 分 节点 失效 或 者 无 法 进行 通讯 时 ， 仍然 可 以 继续 处 理 命令 请 求 的 能 力 。 


Redi 1S 集群 数据 共享 +> 


Redis 集群 使 用 数据 分 片 (sharding) 而 非 一 致 性 哈 希 (consistency hashing) 来 实现 : 一 
个 Redis 集群 包含 16384 MIRAR (hash slot) , 数据 库 中 的 每 个 键 都 属于 这 16384 个 哈 
希 槽 的 其 中 一 个 ， 集群 使 用 公式 cRci6(key) % 16384 来 计算 键 key 属于 哪个 槽 ， 其 中 
cRc16(key) 语句 用 于 计算 键 key 的 CRC16 校 验 和 。 


集群 中 的 每 个 节点 负责 处 理 一 部 分 哈 希 模 。 举 个 例子 ， 一 个 集群 可 以 有 三 个 哈 希 槽 ， 其 中 : 


e。 节点 A 负责 义理 م‎ 5500 5AT, 
e 节点 B ARE 5501 号 至 11000 SHAE, 


e 节点 C 负责 处 理 11001 号 至 16384 SABE, 


+ 


这 种 将 哈 希 模 分布 到 不 同 节点 的 做 法 使 得 用 户 可 以 很 容易 地 向 集群 中 添加 或 者 删除 节点 。 比 
如 说 : 


。 如 果 用 户 将 新 节点 D 添加 到 集群 中 ， 那么 集群 只 需要 将 节点 A、B 、 C 中 的 某 些 槽 移 
动 到 节点 就 可 以 了 。 

٠ 与 此 类 似 ， 如 果 用 户 要 从 集群 中 移 除 节点 A， 那么 集群 只 需要 将 节点 A 中 的 所 有 哈 希 模 
移动 到 节点 B 和 节点 C ， 然后 再 移 除 空白 〈 不 包含 任何 哈 希 槽 ) 的 节点 A 就 可 以 了 。 


因为 将 一 个 哈 希 槽 从 一 个 节点 移动 到 另 一 个 节点 不 会 造成 节点 阻塞 ， 所 以 无 论 是 添加 新 节点 
还 是 移 除 已 存在 节点 ， 又 或 者 改变 某 个 节点 包含 的 哈 希 槽 数量 ， 都 不 会 造成 集群 下 线 。 


Redis 集群 中 的 主 从 复制 


为 了 使 得 集群 在 一 部 分 节点 下 线 或 者 无 法 与 集群 的 大 多 数 (majority) 节点 进行 通讯 的 情况 
下 ， 仍然 可 以 正常 运作 ， Redis 集群 对 节点 使 用 了 主 从 复制 功能 : 集群 中 的 每 个 节点 都 有 
1 个 至 n 个 复制 品 (replica) , 其 中 一 个 复制 品 为 主 节 点 (master), MHRA N-1 个 
复制 品 为 从 节点 (slave) 。 


在 之 前 列举 的 节点 A、B 、C 的 例子 中 ， 如 果 节 点 B 下 线 了 ， 那么 集群 将 无 法 正常 运行 ， 
因为 集群 找 不 到 节点 来 处 理 5501 号 至 1100 BREKT., 


另 一 方面 ， 假如 在 创建 集群 的 时 候 (或 者 至 少 在 节点 B 下 线 之 前 ) ， 我 们 为 主 节点 B 添加 
了 从 节点 B1， 那么 当主 节点 B 下 线 的 时 候 ， 集群 就 会 特 B1 设置 为 新 的 主 节 点 ， 并 让 它 代 
替 下 线 的 主 节点 6 , 继续 义理 5501 号 至 11000 号 的 哈 希 槽 ， 这 样 集群 就 不 会 因为 主 节点 
B 的 下 线 而 无 法 正常 运作 了 。 


不 过 如 果 节 点 B 和 B1 都 下 线 的 话 ， Redis 集群 还 是 会 停止 运作 。 


Redis 集群 的 一 致 性 保证 (guarantee) 


Redis 集群 不 保证 数据 的 强 一 致 性 (strong consistency) : 在 特定 条 件 下 ， Redis 集群 可 能 
会 丢失 已 经 被 执行 过 的 写 命 令 。 
使 用 异步 复制 (asynchronous replication) 是 Redis 集群 可 能 会 去 失 写 命令 的 其 中 一 个 原 
A, 考虑 以 下 这 个 写 命 令 的 例子 : 

。 客户 端 向 主 节点 B 发 送 一 条 写 命 邻 。 

٠ 主 节点 B 执行 写 命 令 ， 并 向 客户 端 返回 命令 回复 。 

٠ 主 节 点 B 将 刚刚 执行 的 写 命 令 复 制 给 它 的 从 节点 B1、 82 和 B3 。 


如 你 所 见 ， 主 节 点 对 命令 的 复制 工作 发 生 在 返回 命令 回复 之 后 ， 因为 如 果 每 次 处 理 命令 请 求 
都 需要 等 待 复制 操作 完成 的 话 ， 那么 主 节 点 义理 命令 请 求 的 速度 将 极 大 地 降低 一 一 我 们 必须 
在 性 能 和 一 致 性 之 间 做 出 权衡 。 


Note 


如 果真 的 有 必要 的 话 ， Redis 集群 可 能 会 在 将 来 提供 同步 地 (synchronou) 执行 写 命 令 的 方 
法 。 


Redis 集群 另外 一 种 可 能 会 和 去 失 命令 的 情况 是 ， 集群 出 现 网 络 分 裂 (network partition) ， 并 
且 一 个 客户 端 与 至 少 包括 一 个 主 节点 在 内 的 少数 (minority) 实例 被 孤立 。 


举 个 例子 ， 假设 集群 包含 A、B、C、A1、B1、C1 六 个 节点 ， 其 中 入 、B 、C 为 主 节 
点 ， 而 A1、B1 、C1 分 别 为 三 个 主 节 点 的 从 节点 ， 另外 还 有 一 个 客户 端 Z1 。 


假设 集群 中 发 生 网 络 分 裂 ， 那么 集群 可 能 会 分 裂 为 两 方 ， 大 多 数 (majority) 的 一 方 包含 
AA, C, A1, B14 C1, 而 少数 (minority) 的 一 方 则 包含 节点 B 和 客户 端 Z1 。 


在 网 络 分 裂 期 间 ， 主 节点 B 仍然 会 接受 Z1 发 送 的 写 命 令 : 


٠ 如 果 网 络 分 裂 出 现 的 时 间 很 短 ， مسريو‎ 常 运行 ; 
٠ 但 是 ， 如 果 网 络 分 裂 出 现 的 时 间 足 够 长 ， 使 得 大 多 数 一 方 将 从 节点 B1 设置 为 新 的 主 节 
点 ， 并 使 用 B1 来 代替 原来 的 主 节点 B， وال دعاسن افير‎ 


注意 ， 在 网 络 分 裂 出现 期 间 ， 客户 端 Z1 可 以 向 主 节点 B 发 送 写 命 令 的 最 大 时 间 是 有 限制 
的 ， 这 一 时 间 限 制 称 为 节点 超时 时 间 (node timeout) ， 是 Redis 集群 的 一 个 重要 的 配置 选 


项 : 


。 对 于 大 多 数 一 方 来 说 ， 如 果 一 个 主 节点 未 能 在 节点 超时 时 间 所 设 定 的 时 限 内 重新 联系 上 
集群 ， 那么 集群 会 将 这 个 主 节 点 视 为 下 线 ， 并 使 用 从 节点 来 代 蔡 这 个 主 节 点 继续 工作 。 
。 对 于 少数 一 方 ， 如 果 一 个 主 节 点 未 能 在 节点 超时 时 间 所 设 定 的 时 限 内 重新 联系 上 集群 
么 它 将 停止 处 理 写 命 合 ， 并 向 客户 端 报告 错误 。 


创建 并 使 用 Redis 集群 


Redis 集群 由 多 个 运行 在 集群 模式 (cluster mode) 下 的 Redis 实例 组 成 ， 实例 的 集群 模式 
需要 通过 配置 来 开启 ， 开 和 启 集群 模式 的 实例 将 可 以 使 用 集群 特有 的 功能 和 命令 。 


以 下 是 一 个 包含 了 最 少 选 项 的 集群 配置 文件 示例 : 


port 7000 

cluster-enabled yes 
cluster-config-file nodes.conf 
cluster-node-timeout 5000 
appendonly yes 


文件 中 的 cluster-enabled 选项 用 于 开 实 例 的 集群 模式 ， 而 cluster-conf-file 选项 则 设 定 
了 保存 节点 配置 文件 的 路 径 ， 默认 值 为 nodes.conf o 


节点 配置 文件 无 须 人 为 修改 ， 它 由 Redis 集群 在 启动 时 创建 ， 并 在 有 需要 时 自动 进行 更 新 。 


要 让 集群 正常 运作 至 少 需要 三 个 主 节 点 ， 不 过 在 刚 开 始 试用 集群 功能 时 ， 强烈 建议 使 用 六 个 
am: 其 中 三 个 为 主 节 点 ， 而 其 余 三 个 则 是 各 个 主 节点 的 从 节点 。 
首先 ， 让 我 们 进入 一 个 新 目录 ， 并 创建 六 个 以 端口 号 为 名 字 的 子 目 录 ， 稍 后 我 们 在 将 每 个 目 
录 中 运行 一 个 Redis 实例 : 

mkdir cluster-test 


cd cluster-test 
mkdir 7000 7001 7002 7003 7004 7005 


在 文件 夹 760@ Æ 7005 中 ， 各 创建 一 个 redis.conf 文件 ， 文件 的 内 容 可 以 使 用 上 面 的 
示例 配置 文件 ， 但 记得 将 配置 中 的 端口 号 从 ووو‎ 改 为 与 文件 夹 名 字 相 同 的 号 码 。 


现在 ， 从 Redis Github 页 面 的 unstable 分 支 中 取出 最 新 的 Redis 源码 ， 编译 出 可 执行 文 
件 redis-server , 并 将 文件 复制 到 cluster-test 文件 夹 ， 然后 使 用 类 似 以 下 命令 ， 在 每 
个 标签 页 中 打开 一 个 实例 : 


cd 7000 
../redis-server ./redis.conf 


实例 打印 的 日 志 显 示 ， 因为 nodes.conf 文件 不 存在 ， 所 以 每 个 节点 都 为 它 自身 指定 了 一 个 
新 的 ID : 


[82462] 26 Nov 11:56:55.329 * No cluster configuration found, I'm 97a3a64667477371c447932 
实例 会 一 直 使 用 同一 个 ID , 从 而 在 集群 中 保持 一 个 独一无二 (unique) HAF. 





每 个 节点 都 使 用 ID 而 不 是 IP 或 者 端口 号 来 记录 其 他 节点 ， AA IP 地 址 和 端口 号 都 可 能 会 改 
变 ， 而 这 个 独一无二 的 标识 符 〈identifier) 则 会 在 节点 的 整个 生命 周期 中 一 直 保 持 不 变 。 


我 们 将 这 个 标识 符 称 为 节点 ID, 
创建 集群 


现在 我 们 已 经 有 了 六 个 正在 运行 中 的 Redis 实例 ， 接 下 来 我 们 需要 使 用 这 些 实例 来 创建 集 
群 ， 并 为 每 个 节点 编写 配置 文件 。 


通过 使 用 Redis 集群 命令 行 工 具 redis-trib ， 编写 节点 配置 文件 的 工作 可 以 非常 容易 地 完 
成 : redis-trib 位 于 Redis 源码 的 src 文件 夹 中 ， 它 是 一 个 Ruby 程序 ， 这 个 程序 通过 
向 实例 发 送 特殊 命令 来 完成 创建 新 集群 ， 检查 集群 ， 或 者 对 集群 进行 重新 分 片 (reshared) 
等 工作 。 


我 们 需要 执行 以 下 命令 来 创建 集群 : 


./redis-trib.rb create --replicas 1 127.0.0.1:7000 127.0.0.1:7001 ١ 
127.0.0.1:7002 127.0.0.1:7003 127.0.0.1:7004 127.0.0.1:7005 


命令 的 意义 如 下 : 


٠ 给 定 redis-trib.rb 程序 的 命令 是 create ， 这 表示 我 们 希望 创建 一 个 新 的 集群 。 

e 选项 --replicas 1 表示 我 们 希望 为 集群 中 的 每 个 主 节点 创建 一 个 从 节点 。 

。 之 后 跟着 的 其 他 参数 则 是 实例 的 地 址 列表 ， 我 们 希望 程序 使 用 这 些 地 址 所 指示 的 实例 来 
创建 新 集群 。 


简单 来 说 ， 以 上 命令 的 意思 就 是 让 redis-trib 程序 创建 一 个 包含 三 个 主 节点 和 三 个 从 节点 
的 集群 。 


接着 ， redis-trib 会 打印 出 一 份 预想 中 的 配置 给 你 看 ， 如 果 你 觉得 没 问 题 的 话 ， 就 可 以 输 
人 yes و‎ redis-trib 就 会 笃 这 份 配置 应 用 到 集群 当中 : 


>>> Creating cluster 


Connecting to node 127.0.0.1:7000: OK 
Connecting to node 127.0.0.1:7001: OK 
Connecting to node 127.0.0.1:7002: OK 
Connecting to node 127.0.0.1:7003: OK 
Connecting to node 127.0.0.1:7004: OK 
Connecting to node 127.0.0.1:7005: OK 


>>> Performing hash slots allocation on 6 nodes... 
Using 3 masters: 


127.0.0.1: 7000 
127.0.0.1: 7001 
127.0.0.1: 7002 
127.0.0.1:7000 replica #1 is 127.0.0.1:7003 
127.0.0.1:7001 replica #1 is 127.0.0.1:7004 
127.0.0.1:7002 replica #1 is 127.0.0.1:7005 


M: 9991306f0e50640a5684f1958fd754b38fa034c9 127.0.0.1:7000 
slots:0-5460 (5461 slots) master 
M: e68e52cee0550F558b03b342F2F0354d2b8a083b 127.0.0.1:7001 
slots:5461-10921 (5461 slots) master 
M: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127. 
slots:10922-16383 (5462 slots) master 
S: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127.0.0.1:7003 
S: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127.0.0.1:7004 
0 
0 


© 
© 


.1: 7002 


S: 3375be2ccc321932e8853234ffa87ee9fde973ff 127.0.0.1:7005 
Can I set the above configuration? (type 'yes' to accept): yes 


输入 yes 并 按 下 回 车 确认 之 后 ， 集群 就 会 将 配置 应 用 到 各 个 节点 ， 并 连接 起 (join) 各 个 节 
点 一 一 也 即 是 ， 让 各 个 节点 开始 互相 通讯 : 


>>> Nodes configuration Updated 

>>> Sending CLUSTER MEET messages to join the cluster 
Waiting for the cluster to join... 

>>> Performing Cluster Check (using node 127.0.0.1:7000) 
M: 9991306f0e50640a5684f1958fd754b38fa034c9 127.0.0.1:7000 
slots:0-5460 (5461 slots) master 

M: e68e52cee0550F558b03b342F2F0354d2b8a083b 127.0.0.1:7001 
slots:5461-10921 (5461 slots) master 

M: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127.0.0.1:7002 
slots:10922-16383 (5462 slots) master 

M: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127.0.0.1:7003 
slots: (0 slots) master 

M: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127.0.0.1:7004 
slots: (0 slots) master 

M: 3375be2ccc321932e8853234ffa87ee9fde973FF 127.0.0.1:7005 
slots: (0 slots) master 

[OK] All nodes agree about slots configuration. 


如 果 一 切 正 常 的 话 ， redis-trib 将 输出 以 下 信息 


>>> Check for open slots... 
>>> Check slots coverage... 
[OK] All 16384 slots covered. 


这 表示 集群 中 的 16384 个 槽 都 有 至 少 一 个 主 节 点 在 处 理 ， 集群 运作 正常 。 


REFIZE P im 
Redis 集群 现 阶 段 的 一 个 问题 是 客户 端 实现 很 少 。 以 下 是 一 些 我 知道 的 实现 : 


e redis-rb-cluster 是 我 (@antirez) 编写 的 Ruby 实现 ， 用 于 作为 其 他 实现 的 参考 。 该 
实现 是 对 redis-rb 的 一 个 简单 包装 ， 高 效 地 实现 了 与 集群 进行 通讯 所 需 的 最 少 语义 
(semantic) 。 

e redis-py-cluster 看 上 去 是 redis-rb-cluster 的 一 个 Python 版 本 ， 这 个 项 目 有 一 段 
时 间 没 有 更 新 了 最 后 一 次 提交 是 在 六 个 月 之 前 ) ， 不 过 可 以 将 这 个 项 目 用 作 学 习 集 群 
的 起 点 。 

。 流行 的 Predis 佛经 对 早期 的 Redis 集群 有 过 一 定 的 支持 ， 但 我 不 确定 它 对 集群 的 支持 是 
否 完整 ， 也 不 清楚 它 是 否 和 最 新 版 本 的 Redis 集群 兼容 (因为 新 版 的 Redis 集群 将 模 的 
数量 从 4k 改 为 16k 了 ) 。 

e Redis unstable 分 支 中 的 redis-cli 程序 实现 了 非常 基本 的 集群 支持 ， 可 以 使 用 命令 
redis-cli -c 来 启动 。 


测试 Redis 集群 比较 简单 的 办 法 就 是 使 用 redis-rb-cluster 或 者 redis-cli , 接 下 来 我 们 
将 使 用 redis-cli 为 例 来 进行 演示 : 


$ redis-cli -c -p 0 

redis 127.0.0.1:7000> set foo bar 

-> Redirected to slot [12182] located at 127.0.0.1:7002 
OK 

redis 127.0.0.1:7002> set hello world 

-> Redirected to slot [866] located at 127.0.0.1:7000 
OK 

redis 127.0.0.1:7000> get foo 

-> Redirected to slot [12182] located at 127.0.0.1:7002 
"bar" 


redis 127.0.0.1:7000> get hello 
-> Redirected to slot [866] located at 127.0.0.1:7000 
"world" 


redis-cli 对 集群 的 支持 是 非常 基本 的 ， 所 以 它 总 是 依靠 Redis 集群 节点 来 将 它 转 向 
(redirect) 至 正确 的 节点 。 


一 个 真正 的 (serious) 集群 客户 端 应 该 做 得 比 这 更 好 : 它 应 该 用 缓存 记录 起 哈 希 槽 与 节点 地 
址 之 间 的 映射 (map) ， 从 而 直接 将 命令 发 送 到 正确 的 节点 上 面 。 


这 种 映射 只 会 在 集群 的 配置 出 现 某 些 修改 时 变化 ， 比 如 说 ， 在 一 次 故障 转移 (failover) 之 
后 ， 或 者 系统 管理 员 通 过 添加 节点 或 移 除 节 点 来 修改 了 集群 的 布局 (layout) 之 后 ， 诸如 此 


Ro 


使 用 redis-rb-cluster 编写 一 个 示例 应 用 
在 展示 如 何 使 用 集群 进行 故障 转移 、 重 新 分 片 等 操作 之 前 ， 我 们 需要 创建 一 个 示例 应 用 ， 了 
解 一 些 与 Redis 集群 客户 端 进行 交互 的 基本 方法 。 


在 运行 示例 应 用 的 过 程 中 ， 我 们 会 尝试 让 节点 进入 失效 状态 。 又 或 者 开始 一 次 重新 分 片 ， 以 
此 来 观察 Redis 集群 在 真实 世界 运行 时 的 表现 ， 并 且 为 了 让 这 个 示例 尽 可 能 地 有 用 ， 我 们 会 
让 这 个 应 用 向 集群 进行 写 操作 。 


本 节 将 通过 两 个 示例 应 用 来 展示 redis-rb-cluster 的 基本 用 法 ， 以 下 是 本 节 的 第 一 个 示例 应 
用 ， 它 是 一 个 名 为 example.rb 的 文件 ， 包含 在 redis-rb-cluster 项 目 里 面 : 


جرادم ين حط ان © ل- 60 فى 


require './cluster' 


startup_nodes = [ 
{:host =&gt; "127.0.0.1", :port =&gt; 7000}, 
{:host =&gt; "127.0.0.1", :port =&gt; 7001} 
] 


rc = RedisCluster.new(startup_nodes, 32,: timeout =&gt; 0.1) 
last = false 


while not last 
begin 
last = rc.get("__last__") 
last = 0 if !last 
rescue =&gt; e 
puts "error #{e.to_s}" 
sleep 1 
end 
end 


((last.to_i+1)..1000000000) .each{&#124 ; x&#124; 
begin 
rc.set("foo#{x}",x) 
puts rc.get("foo#{x}") 
rc.set("__last__",x) 
rescue =&gt; ع‎ 
puts "error #f{e.to_s}" 
end 
sleep 0.1 


这 个 应 用 所 做 的 工作 非常 简单 : 它 不 断 地 以 fooalt;numberagt; 为 键 ， number 为 值 ， 使 用 
SET 命令 向 数据 库 设置 键 值 对 。 


如 果 我 们 执行 这 个 应 用 的 话 ， 应 用 将 按 顺序 执行 以 下 命令 : 


@ SET foo0 0 
© SET fool 1 
@ SET foo2 2 


9 诸如 此 类 。 o o 


代码 中 的 每 个 集群 操作 都 使 用 一 个 begin 和 rescue 代码 块 (block) 288, 因为 我 们 希 
望 在 代码 出 错时 ， 将 错误 打印 到 终端 上 面 ， 而 不 希望 应 用 因为 异常 (exception) 而 退出 。 


代码 的 第 七 行 是 代码 中 第 一 个 有 趣 的 地 方 ， 它 创建 了 一 个 Redis 集群 对 象 ， 其 中 创建 对 象 所 
使 用 的 参数 及 其 意义 如 下 : 


。 第 一 个 参数 是 记录 了 启动 节点 的 startup_nodes WR, 列表 中 包含 了 两 个 集群 节点 的 地 
址 。 

。 第 二 个 参数 指定 了 对 于 集群 中 的 各 个 不 同 的 节点 ， Redis 集群 对 象 可 以 获得 (take) 的 
最 大 连接 数 (maximum number of connections this object is allowed to take) 。 

。 第 三 个 参数 timeout 指定 了 一 个 命令 在 执行 多 久之 后 ， 才 会 被 看 作 是 执行 失败 。 


记 住 ， 和 启动 列表 中 并 不 需要 包含 所 有 集群 节点 的 地 址 ， 但 这 些 地 址 中 至 少 要 有 一 个 是 有 效 的 
(reachable) : -8 redis-rb-cluster 成 功 连接 上 集群 中 的 某 个 节点 时 ， 集群 节点 列表 就 
会 被 自动 更 新 ， 任何 真正 的 (serious) 的 集群 客户 端 都 应 该 这 样 做 。 


现在 ， 程序 创建 的 Redis 集群 对 象 实例 被 保存 到 rc 变量 里 面 ， 我 们 可 以 将 这 个 对 象 当 作 
普通 Redis 对 象 实例 来 使 用 。 


在 十 一 至 十 九 行 ， 我 们 先 尝试 阅读 计数 器 中 的 值 ， 如 果 计 数 器 不 存在 的 话 ， 我 们 才 将 计数 器 
初始 化 为 o : 通过 将 计数 值 保 存 到 Redis 的 计数 器 里 面 ， 我 们 可 以 在 示例 重启 之 后 ， 仍然 
继续 之 前 的 执行 过 程 ， 而 不 必 每 次 重启 之 后 都 从 fooo 开始 重新 设置 键 值 对 。 


为 了 让 程序 在 集群 下 线 的 情况 下 ， 仍然 不 断 地 尝试 读 取 计数 器 的 值 ， 我 们 将 读 取 操 作 包 含 在 
了 一 个 while 循环 里 面 ， 一 般 的 应 用 程序 并 不 需要 如 此 小 心 。 


二 十 一 至 三 十 行 是 程序 的 主 循环 ， 这 个 循环 负责 设置 键 值 对 ， 并 在 设置 出 错时 打印 错误 信 
息 


INO 


程序 在 主 循环 的 末尾 添加 了 一 个 sleep 调用 ， 让 写 操 作 的 执行 速度 变 慢 ， 帮助 执行 示例 的 
人 更 容易 看 清 程序 的 输出 。 


执行 example.rb 程序 将 产生 以 下 输出 : 


uby ./example.rb 


ص 
1 
2 
3 
4 
5 
6 
7 
8 
9 


这 个 程序 并 不 是 十 分 有 趣 ， 稍 后 我 们 就 会 看 到 一 个 更 有 趣 的 集群 应 用 示例 ， 不 过 在 此 之 前 ， 
让 我 们 先 使 用 这 个 示例 来 演示 集群 的 重新 分 片 操 作 。 


对 集群 进行 重新 分 片 
现在 ， 让 我 们 来 试 试 对 集群 进行 重新 分 片 操作 。 


在 执行 重新 分 片 的 过 程 中 ， 请 让 你 的 example.rb 程序 处 于 运行 状态 。 这 样 你 就 会 看 到 ， Æ 
新 分 片 并 不 会 对 正在 运行 的 集群 程序 产生 任何 影响 ， 你 也 可 以 考虑 将 example.rb 中 的 
sleep 调用 删 掉 ， 从 而 让 重新 分 片 操作 在 近乎 真实 的 写 负 载 下 执行 。 


重新 分 片 操作 基本 上 就 是 将 某 些 节点 上 的 哈 希 模 移 动 到 另外 一 些 节点 上 面 ， 和 创建 集群 一 
AF 重新 分 片 也 可 以 使 用 redis-trib 程序 来 执行 。 


执行 以 下 命令 可 以 开始 一 次 重新 分 片 操作 : 


$ ./redis-trib.rb reshard 127.0.0.1:7000 


你 只 需要 指定 集群 中 其 中 一 个 节点 的 地 址 ， redis-trib 就 会 自动 找到 集群 中 的 其 他 节点 。 


目前 redis-trib 只 能 在 管理 员 的 协助 下 完成 重新 分 片 的 工作 ， 要 让 redis-trib 自动 将 哈 
希 模 从 一 个 节点 移动 到 另 一 个 节点 ， 目前 来 说 还 做 不 到 (不 过 实现 这 个 功能 并 不 难 ) 。 


执行 redis-trib 的 第 一 步 就 是 设 定 你 打算 移动 的 哈 希 模 的 数量 : 


$ ./redis-trib.rb reshard 127.0.0.1:7000 
Connecting to node 127.0.0.1:7000: OK 
Connecting to node 127. :7002: OK 
Connecting to node 127. :7005: OK 
Connecting to node 127. :7001: OK 
Connecting to node 127. 17003: OK 
Connecting to node 127.0.0.1:7004: OK 
>>> Performing Cluster Check 
M: 9991306f0e50640a5684F1958fd754b38fFa034c9 127 
slots:0-5460 (5461 slots) master 

M: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127 
slots:10922-16383 (5462 slots) master 

S: 3375be2ccc321932e8853234ffa87ee9fde973FF 127 
slots: (0 slots) slave 

M: e68e52cee0550F558b03b342F2F0354d2b8a083b 127 
slots:5461-10921 (5461 slots) master 

S: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127 
slots: (0 slots) slave 

S: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127 


هه واه 
ه وه واه 
جم خم كر كم 


(using node 127.0.0.1:7000) 
.0.0.1: 7000 


0.0.1: 7002 
0.0.1: 7005 
0.0.1: 7001 
0.0.1: 7003 


0.0.1: 7004 


slots: (0 slots) slave 

[OK] All nodes agree about slots configuration. 

>>> Check for open slots... 

>>> Check slots coverage... 

[OK] All 16384 slots covered. 

How many slots do you want to move (from 1 to 16384)? 1000 


我 们 将 打算 移动 的 槽 数量 设置 为 1000 个 ， 
1000 个 槽 里面 应 该 有 不 少 键 了 。 


如 果 example.rb 程序 一 直 运 行 着 的 话 ， 现在 


除了 移动 的 哈 希 槽 数量 之 外 ， redis-trib 还 需要 知道 重新 分 片 的 目标 (target node) ， 也 


Bl, 负责 接收 这 1000 个 哈 希 槽 的 节点 。 
指定 目标 需要 使 用 节点 的 ID ， 而 不 是 IP 地 址 和 端口 。 比如 说 ， 我 们 打算 使 用 集群 的 第 一 个 
主 节点 来 作为 目标 ， 它 的 IP 地 址 和 端口 是 127.0.0.1:7000 , 而 节点 ID ME 
9991306f0e50640a5684f1958fd754b38fa034c9 , 那么 我 们 应 该 向 redis-trib 提供 节点 的 1D 

$ ./redis-trib.rb reshard 127.0.0.1:7000 

what is the receiving node ID? 9991306f0e50640a5684f1958fd754b38fa034c9 
Note 

redis-trib 会 打印 出 集群 中 所 有 节点 的 ID ， 并 且 我 们 也 可 以 通过 执行 以 下 命令 来 获得 节点 
的 运行 ID 


$ ./redis-cli -p 7000 cluster nodes | grep myself 
9991306f0e50640a5684F1958Fd754b38Ffa034c9 :0 myself,master - © © © connected 0-5460 


接着 ， redis-trib 会 向 你 询问 重新 分 片 的 源 节点 (source node) , 
点 中 取出 1000 个 哈 希 槽 ， 并 将 这 些 槽 移动 到 目标 节点 上 面 。 


也 即 是 ， 要 从 哪个 节 


如 果 我 们 不 打算 从 特定 的 节点 上 取出 指定 数量 的 哈 希 槽 ， 那么 可 以 向 redis-trib 输入 all 
, 这 样 的 话 ， 集群 中 的 所 有 主 节点 都 会 成 为 源 节点 ， redis-trib 将 从 各 个 源 节 点 中 各 取出 
一 部 分 哈 希 槽 ， #44 1000 个， 然后 移动 到 目标 节点 上 面 : 


$ ./redis-trib.rb reshard 127.0.0.1:7000 


Please enter all the source node IDs. 
to use all the nodes as source nodes for the hash slots. 


‘all' 
"done' 


Type 
Type 


once you entered all the source nodes IDs. 
Source node #1:all 


输入 all 并 按 下 回 车 之 后 ， 


的 话 ， 


$ ./redis-trib.rb reshard 127.0.0.1:7000 


Moving slot 
Moving slot 
Moving slot 
Moving slot 


Moving slot 
Do you want 


redis-trib 将 打印 出 哈 希 槽 的 移动 计划 ， 


就 可 以 输入 yes 并 再 次 按 下 回 车 : 


11421 from 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 
11422 from 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 
5461 from 06865 26 055015503342152 0 
5469 from 66865206 055015590334212 2-0 


5959 from e68e52cee0550f558b03b342f2f0354d2b8a083b 
to proceed with the proposed reshard plan (yes/no)? yes 


输入 yes 并 使 用 按 下 回 车 之 后 ， 


哈 希 槽 从 源 节 


点 一 个 个 


IW 


$ ./redis-trib.rb reshard 


Moving slot 
Moving slot 
Moving slot 
Moving slot 


Moving slot 


5934 
5935 
5936 
5937 


5959 


from 
from 
from 
from 


from 


在 重新 分 片 的 过 程 中 ， 


在 重新 分 片 操 作 执行 完毕 之 后 ， 可 以 使 用 以 下 命令 来 检查 集群 是 否 


127. 
127. 
127. 
127. 


127. 


127 


[o) 
95 
BB 


6ه واه 
6ه واه 
BEEBE‏ 


redis-trib 


: 7001 
: 7001 
: 7001 
: 7001 


: 7001 


0.0.1: 7000 


to 
to 
to 
to 


to 


地 移动 到 目标 节点 上 面 : 


127. 
127. 
127. 
AAT Et 


127. 


如 果 你 觉得 


就 会 正式 开始 执行 重新 分 片 操 作 ， 


example.rb 应 该 可 以 继续 


FRR FRR 


:7000 : 
:7000 : 
:7000 : 
:7000 : 


:7000 : 


常 运行 ， 


会 出 
GigE 


现任 何 问题 。 


atk 


IL 
NIN 


F/X 


又 问题 


题 


$ ./redis-trib.rb check 127.0.0.1:7000 


Connecting to node 127.0.0.1:7000: OK 
Connecting to node 127.0.0.1:7002: OK 
Connecting to node 127.0.0.1:7005: OK 
Connecting to node 127.0.0.1:7001: OK 
Connecting to node 127.0.0.1:7003: OK 


Connecting to node 127.0.0.1:7004: OK 

>>> Performing Cluster Check (using node 127.0.0.1:7000) 
M: 9991306f0e50640a5684f1958fd754b38fa034c9 127.0.0.1:7000 
slots:0-5959,10922-11422 (6461 slots) master 

M: 393c6df5eb4b4cec323f0e4ca961c8b256e3460a 127.0.0.1:7002 
slots:11423-16383 (4961 slots) master 

S: 3375be2ccc321932e8853234Fffa87ee9fde973FF 127.0.0.1:7005 
slots: (0 slots) slave 

M: e68e52cee0550F558b03b342F2F0354d2b8a083b 127.0.0.1:7001 
slots:5960-10921 (4962 slots) master 

S: 48b728dbcedff6bf056231eb44990b7d1c35c3e0 127.0.0.1:7003 
slots: (0 slots) slave 

S: 345ede084ac784a5c030a0387f8aaa9edfc59af3 127.0.0.1:7004 
slots: (0 slots) slave 

[OK] All nodes agree about slots configuration. 

>>> Check for open slots... 

>>> Check slots coverage... 

[OK] All 16384 slots covered. 


根据 检查 结果 显示 ， 集群 运作 正常 。 


注意 的 就 是 ， 在 三 个 主 节点 中 ， 节点 127.0.0.1:7000 包含 了 6461 MER, 而 节点 
127.0.0.1:7001 和 节点 127.0.0.1:7002 都 只 包含 了 4961 CRAH, 因为 后 两 者 都 将 自己 
的 soo 个 哈 希 槽 移动 到 了 节点 127.0.0.1:7000 o 


一 个 更 有 趣 的 示例 应 用 


我 们 在 前 面 使 用 的 示例 程序 example.rb 并 不 是 十 分 有 趣 ， 因为 它 只 是 不 断 地 对 集群 进行 写 
A, 但 并 不 检查 写 入 结果 是 否 正 确 。 比如 说 ， 集群 可 能 会 错误 地 将 example.rb 发 送 的 所 有 
SET 命令 都 改 成 了 SET foo 42 و‎ 但 因为 example.rb 并 不 检查 写 入 后 的 值 ， 所 以 它 不 会 意 
识 到 集群 实际 上 写 入 的 值 是 错误 的 。 


因为 这 个 原因 ， redis-rb-cluster 项 目 包含 了 一 个 名 为 consistency-test.rb 的 示例 应 用 ， 这 个 
应 用 比 起 example.rb 有 趣 得 多 : 它 创 建 了 多 个 | 计数 器 (默认 为 1000 个 ) ， 并 通过 发 送 
INCR 命令 来 增加 这 些 计 数 器 的 值 。 


在 增加 计数 器 值 的 同时 ， consistency-test.rb 还 执行 以 下 操作 : 


٠ 每 次 使 用 INCR 命令 更 新 一 个 计数 器 时 ， 应 用 会 记录 下 计数 器 执行 INCR 命令 之 后 应 该 
有 的 值 。 举 个 例子 ， 如 果 计数 器 的 起 始 值 为 9 , 而 这 次 是 程序 第 50 次 向 它 发 送 
INCR #843, 那么 计数 器 的 值 应 该 是 50 。 

。 在 每 次 发 送 Ac 程序 会 随机 从 集群 中 读 取 一 个 计数 器 的 值 ， 并 将 它 与 自己 
记录 的 值 进行 对 比 ， 看 两 个 值 是 否 相 同 。 


换 句 话说 ， 这 个 程序 是 一 个 一 致 性 检查 器 (consistency checker) : 如 果 集 群 在 执行 INCR 
命令 的 过 丢失 了 某 条 INCR MG, 又 或 者 多 执行 了 某 条 客户 端 没有 确认 到 的 INCR © 
令 ， 那 么 检查 器 将 察觉 到 这 一 点 一 一 在 前 一 种 情况 中 ， consistency-test.rb 记录 的 计数 器 
值 将 比 集群 记录 的 计数 器 值 要 大 ; 而 在 后 一 种 情况 中 ， consistency-test.rb 记录 的 计数 器 
值 将 比 集群 记录 的 计数 器 值 要 小 。 


运行 consistency-test 程序 将 产生 类 似 以 下 的 输出 : 


$ ruby consistency-test.rb 

925 R (© err) | 925 w (0 err) | 
5030 R (0 err) | 5030 w (0 err) | 
9261 R (© err) | 9261 W (0 err) | 
13517 R (© err) | 13517 W (© err) 
17780 R (© err) | 17780 w (© err) 
22025 R (© err) | 22025 W (0 err) 
25818 R (© err) | 25818 W (0 err) 


每 行 输出 都 打印 了 程序 执行 的 读 取 次 数 和 写 入 次 数 ， 以 及 执行 操作 的 过 程 中 因为 集群 不 可 用 
而 产生 的 错误 数 。 


如 果 程 序 察 党 了 不 一 致 的 情况 出 现 ， 它 将 在 输出 行 的 末尾 显 式 不 一 致 的 详细 情况 。 
比如 说 ， 如 果 我 们 在 consistency-test.rb 运行 的 过 程 中 ， 手动 修改 某 个 计数 器 的 值 : 


$ redis 127.0.0.1:7000> set key_217 0 
OK 


ARZ consistency-test.rb 将 向 我 们 报告 不 一 致 情况 : 


(in the other tab I see...) 


94774 R (© err) | 94774 W (@ err) | 
98821 R (© err) | 98821 w (O err) | 
102886 R (© err) | 102886 W (© err) | 114 lost | 
107046 R (© err) | 107046 W (© err) | 114 lost | 


在 我 们 修改 计数 器 值 的 时 候 ， 计数 器 的 正确 值 是 114 (执行 了 114 次 INCR AS), A 
为 我 们 将 计数 器 的 值 设 成 了 o ， 所 以 consistency-test.rb 会 向 我 们 报告 说 丢失 了 114 
个 INCR #7. 


因为 这 个 示例 程序 具有 一 致 性 检查 功能 ， 所 以 我 们 用 它 来 测试 Redis 集群 的 故障 转移 操作 。 


故障 转移 测试 
Note 


在 执行 本 节操 作 的 过 程 中 ， 请 一 直 运 行 consistency-test 程序 。 
要 触发 一 次 故障 转移 ， 最 简单 的 办 法 就 是 合集 群 中 的 某 个 主 节点 进入 下 线 状态 。 


首先 用 以 下 命 邻 列 出 集群 中 的 所 有 主 节点 : 


$ redis-cli -p 7000 cluster nodes | grep master 

3e3a6cb0d9a9a87168e266b0a0b24026cOaae3fO 127.0.0.1:7001 master - © 1385482984082 © connec 
2938205e12de373867bf38Fica29d31d0ddb3e46 127.0.0.1:7002 master - © 1385482983582 © connec 
97a3a64667477371C4479320d683e4c8db5858b1 :0 myself,master - © © © connected 0-5959 10922- 


al == =] 








过 命令 输出 ， 我 们 知道 端口 号 为 7000 . 7001 和 7002 的 节点 都 是 主 节点 ， 然后 我 们 
以 通过 向 端口 号 为 7002 的 主 节点 发 送 DEBUG SEGFAULT 命令 ， 让 这 个 主 节 点 崩溃 : 


$ redis-cli -p 7002 debug segfault 
Error: Server closed the connection 


现在 ， 切换 到 运行 着 consistency-test 的 标签 页 ， 可 以 看 到 ， consistency-test 在 7002 
下 线 之 后 的 一 段 时 间 里 将 产生 大 量 的 错误 警告 信息 : 


18849 R (0 err) | 18849 W (0 err) | 
23151 R (© err) | 23151 w (O err) | 
27302 R (0 err) | 27302 W (0 err) | 


. many error warnings here ... 


29659 R (578 err) 
33749 R (578 err) 
37918 R (578 err) 
42077 R (578 err) 


29660 W (577 err) | 
33750 W (577 err) | 
37919 W (577 err) | 
42078 W (577 err) | 


M consistency-test 的 这 段 输出 可 以 看 到 ， 集群 在 执行 故障 转移 期 间 ， 总 共 丢 失 了 578 
个 读 命令 和 57 PST, 但 是 并 没有 产生 任何 数据 不 一 致 。 


这 听 上 去 可 能 有 点 奇怪 ， 因为 在 教程 的 开头 我 们 提 到 过 ， Redis 使 用 的 是 异步 复制 ， 在 执行 
故障 转移 期 间 0 集群 可 能 会 去 失 写 命 Ap a o 


但 是 在 实际 上 ， ee 00 ,الا‎ 因为 Redis 几乎 是 同时 执行 将 命令 回复 发 送 给 客 
户 端 ， 以 及 将 命令 复制 给 从 节点 这 两 个 操作 ， 所 以 实际 上 造成 命令 丢失 的 时 间 窗 口 是 非 常 小 
的 。 


不 过 ， 尽管 出 现 的 几率 不 高 ， 但 去 失 命令 的 情况 还 是 有 可 能 会 出 现 的 ， 所 以 我 们 对 Redis 
集群 不 能 提供 强 一 致 性 的 这 一 描述 仍然 是 正确 的 。 


现在 ， 让 我 们 使 用 cluster nodes MD, 查看 集群 在 执行 故障 转移 操作 之 后 ， 主 从 节点 的 
布局 情况 : 


$ redis-cli -p 7000 cluster nodes 

3fc783611028b1707Fd65345e763befb36454d73 127.0.0.1:7004 slave 3e3a6cbh0d9a9a87168e266b0a0b 
a211e242fc6b22a9427Fed61285e85892Ffa04e08 127.0.0.1:7003 slave 97a3a64667477371cC4479320d68 
97a3a64667477371C4479320d683e4c8db5858b1 :0 myself,master - © © © connected 0-5959 10922- 
3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 127.0.0.1:7005 master - © 1385503419023 3 connec 
3e3a6ch0d9a9a87168e266b0a0b24026cOaae3fO 127.0.0.1:7001 master - © 1385503417005 © connec 
2938205e12de373867bf38Fica29d31d0ddb3e46 127.0.0.1:7002 slave 3c3a0c74aae0b56170ccb03a76b 


| Sey 
我 重启 了 之 前 下 线 的 127.0.0.1:7002 节点 ， 该 节点 已 经 从 原来 的 主 节点 变 成 了 从 节点 ， 而 


现在 集群 中 的 三 个 主 节点 分 别 是 127.0.0.1:7000 . 127.0.0.1:7001 和 127.0.0.1:7005 و‎ 
其 中 127.0.0.1:7005 就 是 因为 127.0.0.1:7002 下 线 而 变 成 主 节点 的 。 








cluster nodes 命令 的 输出 有 点 儿 复杂 ， 它 的 每 一 行 都 是 由 以 下 信息 组 成 的 : 


e 节点 ID : 例如 3fc783611028b1707fd65345e763befb36454d73 o 

e ip:port :节点 的 IP 地 址 和 端口 号 ， 例如 127.0.0.1:7000 ， 其 中 :6 表示 的 是 客户 
端 当前 连接 的 IP 地 址 和 端口 号 。 

© flags : 节点 的 角色 ( 例 如 master 、 slave 、 myself ) 以 及 状态 (例如 fail) و‎ 
等 等 ) 。 

٠ 如 果 节 点 是 一 个 从 节点 的 话 ， 那么 跟 在 flags 之 后 的 将 是 主 节 点 的 节点 ID : 例如 
127.0.0.1:7002 的 主 节点 的 节点 ID 就 是 scsagc74aaegb56179ccbg3sa76b6gcfe7dc1912e o 

。 集群 最 近 一 次 向 节点 发 送 PING MRA, 过 去 了 多 长 时 间 还 没 接 到 回复 。 

٠ 节点 最 近 一 次 返回 pons 回复 的 时 间 。 

° oe 纪元 (configuration epoch) : 详细 信息 请 参考 Redis 集群 规范 。 

٠ 本 节点 的 网 络 连接 情况 : 例如 connected o 

٠ 节点 目前 包含 的 槽 : 例如 127.0.0.1:7001 目前 包含 号 码 为 5960 至 10921 WIT. 


添加 新 节 م‎ 点 到 集群 


根据 新 添加 节 点 的 种 ; 类 ， 我 们 需 要 用 两 种 方法 来 将 新 节 P 点 添加 到 集群 里 面 : 


٠ 如 果 要 添加 的 新 节 سناد الصا‎ 那么 我 们 需要 创建 一 点 (empty node) , 然 
后 将 某 些 哈 希 桶 移动 到 这 个 空 节点 里 面 。 

。 另 一 方面 ， ORE RM A 点 是 一 个 从 节点 ， 那么 我 们 需要 将 这 个 新 节点 设置 为 集群 
中 某 个 节点 的 复制 品 (replica) 。 


本 节 P 将 对 以 上 两 种 | 日 况 进 行 介绍 fy 首先 介绍 主 节 点 的 添加 方 法 ， 然后 再 介 从 节 点 的 添加 方 
法 。 


无 论 添加 的 是 那 种 节点 ， 第 一 步 要 做 的 总 是 添加 一 个 空 节点 。 


我 们 可 以 继续 使 用 之 前 启动 127.0.0.1:7000 、 127.0.0.1:7001 等 节点 的 方法 ， 创建 一 个 端 
口号 为 ”7666 的 新 节点 ， 使 用 的 配置 文件 也 和 之 前 一 样 ， 只 是 记得 要 将 配置 中 的 端口 号 改 为 


7000 o 


以 下 是 启动 端口 号 为 7006 的 新 节点 的 详细 步骤 


在 终端 里 创建 一 个 新 的 标签 页 。 

进入 cluster-test 文件 夹 。 

创建 并 进入 7666 文件 夹 。 

将 redis.conf 文件 复制 到 7666 文件 夹 里 面 ， 然 后 将 配置 中 的 端 口号 选项 改 为 7006 


حم 5م دن حل 


5. 使 用 命令 ../../redis-server redis.conf 启动 节点 。 
如 果 一 切 正 常 ， 那么 节 点 应 该 会 会 正确 地 启动 
接 下 来 ， 执行 以 下 命令 ， 将 这 个 新 节点 添加 到 集群 里 面 : 


./redis-trib.rb add-node 127.0.0.1:7006 127.0.0.1:7000 


命令 中 的 add-node 表示 我 们 要 让 redis-trib 将 一 个 节点 添加 到 集群 里 面 ， add-node 之 
后 跟着 的 是 新 节点 的 IP 地 址 和 端口 号 ， 再 之 后 跟着 的 是 集群 中 任意 一 个 已 存在 节点 的 IP 地 
址 和 端口 号 ， 这 里 我 们 使 用 的 是 127.0.0.1:7000 。 


通过 cluster nodes 命令 ， 我 们 可 以 确认 新 节点 127.0.0.1:7006 已 经 被 添加 到 集群 里 面 
T: 


redis 127.0.0.1:7006> cluster nodes 

3e3a6ch0d9a9a87168e266b0a0b24026cOaae3fO 127.0.0.1:7001 master - © 1385543178575 © connec 
3fc783611028b1707fd65345e763befb36454d73 127.0.0.1:7004 slave 3e3a6cb0d9a9a87168e266b0a0b 
f093c80dde814da99c5cf72a7dd01590792b783b :0 myself,master - © © © connected 
2938205e12de373867bf38f1ca29d31d0ddb3e46 127.0.0.1:7002 slave 3c3a0c74aae0b56170ccb03a76b 
a211e242fc6b22a9427fed61285e85892fa04e08 127.0.0.1:7003 slave 97a3a64667477371c4479320d68 
97a3a64667477371c4479320d683e4c8db5858b1 127.0.0.1:7000 master - 0 1385543179080 © connec 
3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 127.0.0.1:7005 master - © 1385543177568 3 connec 


国王 了 | 


新 节点 现在 已 经 连接 上 了 集群 ， 成 为 集群 的 一 份子 ， 并 且 可 以 对 客户 端的 命令 请 求 进行 转向 
T, 但 是 和 其 他 主 节点 相 比 ， 新 节点 还 有 两 点 区 别 : 


。 新 节点 没有 包含 任何 数据 ， 因为 它 没有 包含 任何 哈 
٠ 尽管 新 节点 没有 包含 任何 哈 希 桶 ， 但 它 仍 然 是 一 个 主 节 所 以 在 集群 需要 将 某 个 从 节 
点 升级 为 新 的 主 节点 时 ， 这 个 新 节点 不 会 被 选 


接 下 来 ， 只 要 使 用 redis-trib 程序 ， 将 集群 中 的 某 些 哈 希 桶 移动 到 新 节点 里 面 ， 新 节点 就 
会 成 为 真正 的 主 节点 了 。 





因为 使 用 redis-trib 移动 哈 希 桶 的 方法 在 前 面 已 经 介绍 过 ， 所 以 这 里 就 不 再 重复 介绍 了 
现在 ， 让 我 们 来 看 看 ， 将 一 个 新 节点 转变 为 某 个 主 节点 的 复制 品 ( 也 即 是 从 节点 ) 的 方法 。 


举 个 例子 ， 如 果 我 们 打算 让 新 节点 成 为 127.0.0.1:7005 的 从 节点 ， 那么 我 们 只 要 用 客户 端 
连接 上 新 节点 ， 然后 执行 以 下 命令 就 可 以 了 : 


redis 127.0.0.1:7006> cluster replicate 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 


其 中 命令 提供 的 3c3a0c74aaeb56170ccbo3a76b60cfe7dc1912e 就 是 主 节点 127.0.0.1:7005 AY 
节点 ID 。 


执行 cluster replicate 命令 之 后 ， 我 们 可 以 使 用 以 下 命令 来 确认 127.0.0.1:7006 已 经 成 
ATID 为 3c3a0c74aae0b56170ccb03a76b60cfe7dc1912e 的 节点 的 从 节点 : 


$ redis-cli -p 7000 cluster nodes | grep slave | grep 3c3a0c74aae0b56170ccbh03a76b60cfe7dc 
FO93c80dde814da99c5cFf72a7dd01590792b783b 127.0.0.1:7006 slave 3c3a0c74aae0b56170ccb03a76b 
2938205e12de373867bf38Fica29d31d0ddb3e46 127.0.0.1:7002 5137© <0 


oee = 


3c3agc..， 现 在 有 两 个 从 节点 ， 一 个 从 节点 的 端口 号 为 7002 , 而 另 一 个 从 节点 的 端口 号 
为 7006 。 





移 除 一 个 节点 


未 完 待 续 。 


Redis 集群 规 泄 


Note 


本 文档 翻译 自 http://redis.io/topics/cluster-spec 。 
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这 个 文档 是 正在 开发 中 的 Redis 集群 功能 的 规范 (specification) 文档 ， 文档 分 为 两 个 部 分 : 


Dll 


٠ 第 一 部 分 介绍 目前 已 经 在 _ unstable 分 支 中 实现 了 的 那些 功能 。 
。 第 二 部 分 介绍 目前 仍 未 实现 的 那些 功能 。 


文档 各 个 部 分 的 内 容 可 能 会 随 着 集群 功能 的 设计 修改 而 发 生 改变 ， HH, 未 实现 功能 发 生 修 
改 的 几率 比 已 实现 功能 发 生 修改 的 几率 要 高 。 

这 个 规范 包含 了 编写 客户 端 库 (client library) 所 需 的 全 部 知识 ， 不 过 请 注意 ， 这 里 列 出 的 一 
部 分 细节 可 能 会 在 未 来 发 生变 化 。 


什么 是 Redis 集群 ? 


Redis 集群 是 一 个 分 布 式 (distributed) 、 容 错 (fault-tolerant) 的 Redis Xm, 集群 可 以 使 
用 的 功能 是 普通 单机 Redis 所 能 使 用 的 功能 的 一 个 子 集 (subset) 。 


Redis 集群 中 不 存在 中 心 (central) 节点 或 者 代理 (proxy) 节点 ， 集群 的 其 中 一 个 主要 设计 
目标 是 达到 线性 可 扩展 性 (linear scalability) 。 


Redis 集群 为 了 保证 一 致 性 (consistency) 而 牺牲 了 一 部 分 容错 性 : 系统 会 在 保证 对 网 络 断 
线 (net split) 和 节点 失效 (node failure) 具有 有 限 (limited) 抵抗 力 的 前 提 下 ， 尽 可 能 地 保 
持 数据 的 一 致 性 。 


Note 
集群 笃 节点 失效 视 为 网 络 断 线 的 其 中 一 种 特殊 情况 。 


集群 的 容错 功能 是 通过 使 用 主 节点 (master) 和 从 节点 (slave) 两 种 角色 (role) 的 节点 
(node) 来 实现 的 : 


e 主 节点 和 从 节点 使 用 完全 相同 的 服务 器 实现 ， 它们 的 功能 (functionally) 也 完全 一 祥 ， 
但 从 节点 通常 仅 用 于 替换 失效 的 主 节点 。 

。 Ait, 如 果 不 需 要 保证 “ 先 写 入 ， 后 读 取 ” 操 作 的 一 致 性 (read-after-write 
consistency) ， 那么 可 以 使 用 从 节点 来 执行 只 读 查 询 。 


Redis 集群 实现 的 功能 子 集 


Redis 集群 实现 了 单机 Redis 中 ， 所 有 人 处理 单 个 数据 库 键 的 命 合 。 


针对 多 个 数据 库 键 的 复杂 计算 操作 ， 比如 集合 的 并 集 操 作 、 合 集 操作 没有 被 实现 ， 那些 理论 
需要 使 用 多 个 节点 的 多 个 数据 库 键 才能 完成 的 命令 也 没有 被 实现 。 


在 将 来 ， 用 户 也 许可 以 通过 MIGRATE COPY 命令 ， 在 集群 的 计算 节点 (computation 
node) 中 执行 针对 多 个 数据 库 键 的 只 读 操作 ， 但 集群 本 身 不 会 去 实现 那些 需要 将 多 个 数据 库 
键 在 多 个 节点 中 移 来 移 去 的 复杂 多 键 命令 。 


Redis 集群 不 像 单 机 Redis 那样 支持 多 数据 库 功 能 ， 集群 只 使 用 默认 的 o 号 数据 库 ， FA 
不 能 使 用 SELECT MS. 


Redis 集群 协议 中 的 客户 端 和 服务 器 
Redis 集群 中 的 节点 有 以 下 责任 : 


。 持 有 键 值 对 数据 。 

٠ 记录 集群 的 状态 ， 包 括 键 到 正确 节点 的 映射 (mapping keys to right nodes) 。 

٠ 自动 发 现 其 他 节点 ， 识 别 工 作 不 正常 的 节点 ， 并 在 有 需要 时 ， 在 从 节点 中 选举 出 新 的 主 
节点 


o 


为 了 执行 以 上 列 出 的 任务 ， 集群 中 的 每 个 节点 都 与 其 他 节点 建立 起 了 "集群 连接 (cluster 
bus) ”, 该 连接 是 一 个 TCP 连接 ， 使 用 二 进 制 协议 进行 通讯 。 


节点 之 间 使 用 Gossip 协议 来 进行 以 下 工作 : 


٠ 传播 (propagate) 关于 集群 的 信息 ， 以 此 来 发 现 新 的 节点 。 
e 向 其 他 节点 发 送 PIN6 数据 包 ， 以 此 来 检查 目标 节点 是 否 正常 运作 。 
٠ 在 特定 事件 发 生 时 ， 发 送 集群 信息 。 


除 此 之 外 ， 集群 连接 还 用 于 在 集群 中 发 布 或 订阅 信息 。 


因为 集群 节点 不 能 代理 (proxy) 命令 请 求 ， 所 以 客户 端 应 该 在 节点 返回 -moveo 或 者 -ASK 
转向 (redirection) 错误 时 ， 自行 将 命令 请 求 转 发 至 其 他 节点 。 

因为 客户 端 可 以 自由 地 向 集群 中 的 任何 一 个 节点 发 送 命令 请 求 ， 并 可 以 在 有 需要 时 ， 根据 转 
向 错误 所 提供 的 信息 ， 将 命令 转发 至 正确 的 节点 ， 所 以 在 理论 上 来 说 ， 客户 端 是 无 须 保 存 集 
群 状 态 信 息 的 。 

不 过 ， 如 果 客 户 端 可 以 将 键 和 节点 之 间 的 映射 信息 保存 起 来 ， 可 以 有 效 地 减少 可 能 出 现 的 转 
向 次 数 ， 籍 此 提升 命令 执行 的 效率 。 


键 分 布 模型 


Redis 集群 的 键 空间 被 分 割 为 16384 “MB (slot), 集群 的 最 大 节点 数量 也 是 16384 个 。 
Note 

推荐 的 最 大 节点 数量 为 1000 个 左右 。 

每 个 主 节点 都 负责 处 理 16384 个 哈 希 槽 的 其 中 一 部 分 。 


当 我 们 说 一 个 集群 处 于 “稳定 ”(stable) KAN, 指 的 是 集群 没有 在 执行 重 配置 
(reconfiguration) 操作 ， 每 个 哈 希 模 都 只 由 一 个 节点 进行 处 理 。 


Note 
重 配置 指 的 是 将 某 个 / 某 些 模 从 一 个 节点 移动 到 另 一 个 节点 。 
Note 


一 个 主 


主 节点 可 以 有 任意 多 个 从 节点 ， 这 些 从 节点 用 于 在 主 节点 发 生 网 络 断 线 或 者 节点 失效 
时 ， 对 主 节点 进行 替换 。 


以 下 是 负责 将 键 映射 到 槽 的 算法 : 


HASH_SLOT = CRC16(key) mod 16384 


以 下 是 该 算法 所 使 用 的 参数 : 


。 算法 的 名 称 : XMODEM (又 称 ZMODEM 或 者 CRC-16/ACORN) 

。 结果 的 长 度 : 16 位 

e 多 项 数 (poly) : 1021 (也 即 是 x16 + x12 + x5 + 1( 

。 初始 化 值 : 0 

٠ 反射 输入 字 节 (Reflect Input byte) : False 

٠ 发 射 输出 CRC (Reflect Output CRC) : False 

。 用 于 CRC 输出 值 的 异 或 常量 (Xor constant to output CRC) : 0 
。 该 算法 对 于 输入 "123456789" 的 输出 : 3 


附录 A 中 给 出 了 集群 所 使 用 的 CRC16 算法 的 实现 。 
CRC16 算法 所 产生 的 16 位 输出 中 的 14 位 会 被 用 到 。 


在 我 们 的 测试 中 ， CRC16 算法 可 以 很 好 地 将 各 种 不 同类 型 的 键 平 稳 地 分 布 到 16384 “MEL 
Ho 


REF T BE 


个 节点 在 集群 中 都 有 一 个 独一无二 的 ID ， 该 ID 是 一 个 十 六 进 制 表示 的 160 位 随机 数 ， 在 
/dev/urandom 生成 。 


节点 会 将 它 的 ID 保存 到 配置 文件 ， 只 要 这 个 配置 文件 不 被 删除 ， 节点 就 会 一 直 治 用 这 个 ID 


o 


节点 ID 用 于 标识 集群 中 的 每 个 节点 。 一 个 节点 可 以 改变 它 的 IP 和 端口 号 ， 而 不 改变 节点 ID 
。 集群 可 以 自动 识别 出 IP/ 端 口号 的 变化 ， 并 将 这 一 信息 通过 Gossip 协议 广播 给 其 他 节点 知 
道 


o 


以 下 是 每 个 节点 都 有 的 关联 信息 ， 并 且 节 点 会 将 这 些 信息 发 送 给 其 他 节点 : 


。 节点 所 使 用 的 IP 地 址 和 TCP 端口 号 。 

e 节点 的 标志 (flags) 。 

e 7 ss clue aia 

。 节点 最 近 一 次 使 用 集群 连接 发 送 pinc MH (packet) 的 时 间 。 

° 节点 最 最 近 ee | pone 数据 包 的 时 间 。 

。 集群 将 该 节点 标记 为 下 线 的 时 间 。 

٠ 该 节点 的 从 节点 数量 。 

٠ 如 果 该 节点 是 从 节点 的 话 ， 那 么 它 会 记录 主 节 点 的 节点 ID 。 如 果 这 是 一 个 主 节点 的 话 ， 
那么 主 节点 ID 这 一 栏 的 值 为 0000888 o 


以 上 信息 的 其 中 一 部 分 可 以 通过 向 集群 中 的 任意 节点 ( 主 节点 或 者 从 节点 都 可 以 ) 发 送 


CLUSTER NODES 命令 来 获得 。 


以 下 是 一 个 向 集群 中 的 主 节点 发 送 cluster noes 命令 的 例子 ， 该 集群 由 三 个 节点 组 成 : 


$ redis-cli cluster nodes 

d1861060fe6a534d42d8a19aeb36600e18785e04 :0 myself - © 1318428930 connected 0-1364 
3886e65cc906bFfd9bif7e7bde468726a052d1idae 127.0.0.1:6380 master - 1318428930 1318428931 co 
d289c575dcbc4bdd2931585fd4339089e461a27d 127.0.0.1:6381 master - 1318428931 1318428931 co 


4 a 


在 上 面 列 出 的 三 行 信息 中 ， 从 左 到 右 的 各 个 域 分 别 是 : PAID, IP 地 址 和 端口 号 ， 标志 
(flag) , 最 后 发 送 PIN6 Mati, 最 后 接收 ponc 的 时 间 ， 连接 状态 ， 节点 负责 处 理 的 
if. 





节点 握手 (已 实现 ) 


节点 总 是 应 答 (accept) 来 自 集群 连接 端口 的 连接 请 求 ， 并 对 接收 到 的 pine 数据 包 进 行 回 
复 ， 即使 这 个 pms 数据 包 来 自 不 可 信和 的 节点 。 


然而 ， 除 了 PING 之 外 ， 节点 会 拒绝 其 他 所 有 并 非 来 自 集群 节点 的 数据 包 。 
要 让 一 个 节点 承认 另 一 个 节点 同属 于 一 个 集群 ， 只 有 以 下 两 种 方法 : 


。 一 个 节点 可 以 通过 向 另 一 个 节点 发 送 MEET 信息 ， 来 强制 让 接收 信息 的 节点 承认 发 送信 

息 的 节点 为 集群 中 的 一 份子 。 一 个 节点 仅 在 管理 员 显 式 地 向 它 发 送 
CLUSTER MEET ip port 命令 时 ， 才 会 向 另 一 个 节点 发 送 MEET 信息 。 

。 另外 ， 如 果 一 个 可 信和 节点 向 另 一 个 节点 传播 第 三 者 节点 的 信息 ， 那么 接收 信息 的 那个 节 
点 也 会 将 第 三 者 节点 识别 为 集群 中 的 一 份子 。 也 即 是 说 ， 如 果 A 认 识 B，B 认 识 C， 
并 且 8 向 A 传播 关于 C 的 信息 ， 那么 A 也 会 将 C 识别 为 集群 中 的 一 份子 ， 并 尝试 连接 
Co 


这 意味 着 如 果 我 们 将 一 个 /一 些 新 节点 添加 到 一 个 集群 中 ， 那么 这 个 /这 些 新 节点 最 终 会 和 集群 
中 已 有 的 其 他 所 有 节点 连接 起 来 。 


这 说 明 只 要 管理 员 使 用 cLusTER MET 命令 显 式 地 指定 了 可 信 关 系 ， 集群 就 可 以 自动 发 现 其 
他 节点 。 


这 种 节点 识别 机 制 通过 防止 不 同 的 Redis 集群 因为 IP 地 址 变更 或 者 其 他 网 络 事件 的 发 生 而 产 
意料 之 外 的 联合 (mix), 从 而 使 得 集群 更 具 健壮 性 。 


当 节 点 的 网 络 连接 断 开 时 ， 它 会 主动 连接 其 他 已 知 的 节点 。 


MOVED ماج‎ 


一 个 Redis 客户 端 可 以 向 集群 中 的 任意 节点 (包括 从 节点 ) 发 送 命令 请 求 。 节点 会 对 命令 请 
求 进行 分 析 ， 如 果 该 命令 是 集群 可 以 执行 的 命令 ， 那么 节点 会 查找 这 个 命 合 所 要 处 理 的 键 所 
FE. 


如 果 要 查找 的 哈 希 槽 正好 就 由 接收 到 命令 的 节点 负责 处 理 ， 那么 节点 就 直接 执行 这 个 命令 。 
另 一 方面 ， 如 果 所 查找 的 槽 不 是 由 该 节点 处 理 的 话 ， 节点 将 查看 自身 内 部 所 保存 的 哈 希 槽 到 
节点 ID 的 映射 记录 ， 并 向 客户 端 回复 一 个 MovED 错误 。 

以 下 是 一 个 moven 错误 的 例子 : 


GET x 


-MOVED 3999 127.0.0.1:6381 


蕴 误 信息 包含 键 x 所 属 的 哈 希 权 3999 , 以 及 负责 义理 这 个 模 的 节点 的 IP 和 端口 号 
127.0.0.1:6381 。 客户 端 需要 根据 这 个 IP 和 端口 号 ， 向 所 属 的 节点 重新 发 送 一 次 GET 命 


Bia. 


注意 ， 即使 客户 端 在 重新 发 送 GET 命令 之 前 ， 等 待 了 非常 久 的 时 间 ， 以 至 于 集群 又 再 次 更 
改 了 配置 ， 使 得 节点 127.0.0.1:6381 已 经 不 再 处 理 槽 و3999‎ ， 那么 当 客 户 端 向 节点 
127.0.0.1:6381 KIA GET 命令 的 时 候 ， 节点 将 再 次 向 客户 端 返回 moveo 错误 ， 指示 现在 
负责 处 理 模 3009 的 节点 。 


虽然 我 们 用 ID 来 标识 集群 中 的 节点 ， 但 是 为 了 让 客户 端的 转向 操作 尽 可 能 地 简单 ， 节点 在 
MOVED 错误 中 直接 返回 目标 节点 的 IP 和 端口 号 ， 而 不 是 目标 节点 的 ID 。 


虽然 不 是 必须 的 ， 但 一 个 客户 端 应 该 记录 (memorize) 下 “ 权 3999 由 节点 127.0.0.1:6381 
负责 义理 “这 一 信息 ， 这 样 当 再 次 有 命令 需要 对 模 3999 执行 时 ， 客户 端 就 可 以 加 快 寻找 正 
确 节点 的 速度 。 


注意 ， 当 集 群 处 于 稳定 状态 时 ， 所 有 客户 端 最 终 都 会 保存 有 一 个 哈 希 模 至 节点 的 映射 记录 
(map of hash slots to nodes) ， 使 得 集群 非常 高 效 : 客户 端 可 以 直接 向 正确 的 节点 发 送 命 
兮 请 求 ， 无 须 转向 、 代 理 或 者 其 他 任何 可 能 发 生 单 点 故障 (single point failure) 的 实体 
(entiy) 。 


除了 moveo 转向 错误 之 外 ， 一 个 客户 端 还 应 该 可 以 处 理 稍 后 介绍 的 Ask 转向 错误 。 


集群 在 线 重 配置 (live reconfiguration) 


Redis 集群 支持 在 集群 运行 的 过 程 中 添加 或 者 移 除 节点 。 


实际 上 ， 节点 的 添加 操作 和 节点 的 删除 操作 可 以 抽象 成 同一 个 操作 ， 那 就 是 ， 将 哈 希 槽 从 一 
个 节点 移动 到 另 一 个 节点 : 


。 添加 一 个 新 节点 到 集群 ， 等 于 将 其 他 已 存在 节点 的 槽 移动 到 一 个 空白 的 新 节点 里 面 。 
。 从 集群 中 移 除 一 个 节点 ， 等 于 将 被 移 除 节点 的 所 有 槽 移动 到 集群 的 其 他 节点 上 面 去 。 


因此 ， 实现 Redis 集群 在 线 重 配置 的 核心 就 是 将 槽 从 一 个 节点 移动 到 另 一 个 节点 的 能 力 。 
为 一 个 哈 希 槽 实际 上 就 是 一 些 键 的 集合 ， 所 以 Redis RATE (rehash) 时 真正 要 做 
的 ， 就 是 将 一 些 键 从 一 个 节点 移动 到 另 一 个 节点 。 


要 理解 Redis 集群 如 何 将 槽 从 一 个 节点 移动 到 另 一 个 节点 ， 我 们 需要 对 cLusTER 命令 的 各 
个 子 命令 进行 介绍 ， 这 些 命理 负责 管理 集群 节点 的 槽 转换 表 (slots translation table) 。 


以 下 是 cLusTER 命令 可 用 的 子 命令 : 


e CLUSTER ADDSLOTS slot1 [slot2] ... [slotN] 
®© CLUSTER DELSLOTS slot1 [slot2] ... [slotN] 
e CLUSTER SETSLOT slot NODE node 

e CLUSTER SETSLOT slot MIGRATING node 


@ CLUSTER SETSLOT slot IMPORTING node 


最 开头 的 两 条 命令 AppsLoTS 和 pELsLoTS 分 别 用 于 向 节点 指派 (assign) 或 者 移 除 节点 ， 
当 槽 被 指派 或 者 移 除 之 后 ， 节点 会 业 这 一 信息 通过 Gossip 协议 传播 到 整个 集群 。 AppsLoTS 
命令 通常 在 新 创建 集群 时 ， 作为 一 种 快速 地 将 各 个 槽 指派 给 各 个 节点 的 手段 来 使 用 。 


CLUSTER SETSLOT slot NODE node 子 命令 可 以 将 指定 的 槽 slot 指派 给 节点 node 。 


至 于 CLUSTER SETSLOT slot MIGRATING node 命令 和 CLUSTER SETSLOT slot IMPORTING node 命 
S, 前 者 用 于 将 给 定 节点 node PAE slot 迁移 出 节点 ， 而 后 者 用 于 将 给 定 槽 slot $ 
人 到 节点 node 


。 当 一 个 楷 被 设置 为 TeRATIN6 状态 时 ， 原来 持 有 这 个 档 的 节点 仍然 会 继续 接受 关于 这 个 
槽 的 命令 请 求 ， 但 只 有 命令 所 义理 的 键 仍然 存在 于 节点 时 ， 节点 才 会 处 理 这 个 命 全 请 


如 果 命 令 所 使 用 的 键 不 存在 与 该 节点 ， 那么 节点 将 向 客户 端 返回 一 个 -Ask 转向 
(redirection) 错误 ， 告知 客户 端 ， 要 将 命令 请 求 发 送 到 槽 的 迁移 目标 节点 。 

e 当 一 个 模 被 设置 为 IMPORTIN6 状态 时 ， 节点 仅 在 接收 到 ask 命令 之 后 ， 才 会 接受 
关于 这 个 槽 的 命令 请 求 。 
如 果 客 户 端 没有 向 节点 发 送 askine 命令 ， 那 么 节点 会 使 用 -MovED 转向 错误 将 命令 请 


求 转向 至 真正 负责 处 理 这 个 槽 的 节点 。 


上 面 关 于 MIGRATING 和 IMPORTING 的 说 明 有 些 难 懂 ， 让 我 们 用 一 个 实际 的 实例 来 说 明 一 
下 。 


假设 现在 ， 我 们 有 信和 B 两 个 节点 ， 并 且 我 们 想 将 槽 8 从 节点 A 移 动 到 节点 B ， 于 是 我 
们 : 


e 向 节点 B 发 送 命令 CLUSTER SETSLOT 8 IMPORTING A 
e 向 节点 A 发 送 命令 CLUSTER SETSLOT 8 MIGRATING B 


每 当 客 户 端 向 其 他 节点 发 送 关 于 哈 希 槽 8 的 命令 请 求 时 ， 这 些 节点 都 会 向 客户 端 返回 指向 


٠ 如 果 命令 要 义理 的 键 已 经 存在 于 槽 8 里 面 ， 那 么 这 个 命令 将 由 节点 A RB, 
。 如 果 命 令 要 义理 的 键 未 存在 于 槽 s 里 面 《比如 说 ， 要 向 槽 添加 一 个 新 的 键 ) ， 那么 这 
个 命令 由 节点 B 处 理 。 


这 种 机 制 将 使 得 节点 A 不 再 创建 关于 槽 s 的 任何 新 键 。 


与 此 同时 ， 一 个 特殊 的 客户 端 redis-trib 以 及 Redis 集群 配置 程序 (configuration utility) 
会 将 节点 A قرط‎ 8 里 面 的 键 移动 到 节点 B 。 


键 的 移动 操作 由 以 下 两 个 命令 执行 : 

CLUSTER GETKEYSINSLOT slot count 
上 面 的 命令 会 让 节点 返回 count 个 slot 槽 中 的 键 ， 对 于 命令 所 返回 的 每 个 键 ， 
redis-trib 都 会 向 节点 A 发 送 一 条 MIGRATE HH, 该 命令 会 将 所 指定 的 键 原 子 地 


(atomic) 从 节点 A 移动 到 节点 B 《在 移动 键 期 间 ， 两 个 节点 都 会 处 于 阻塞 状态 ， 以 免 出 现 
竞争 条 件 ) 。 


以 下 为 MIGRATE 命令 的 运作 原理 : 


MIGRATE target_host target_port key target_database id timeout 


执行 MIGRATE 命令 的 节点 会 连接 到 target PR, 并 将 序列 化 后 的 key 数据 发 送 给 
target ， -8 target 返回 OK و‎ 节点 就 将 自己 的 key 从 数据 库 中 删除 。 


从 一 个 外 部 客户 端的 视角 来 看 ， 在 某 个 时 间 点 上 ， 键 key 要 么 存在 于 节点 A， 要 么 存在 于 
PAB, 但 不 会 同时 存在 于 节点 入 和 节点 B。 


为 Redis 集群 只 使 用 o 号 数据 库 ， 所 以 当 MIGRATE 命令 被 用 于 执行 集群 操作 时 ， 


target_database 的 值 总 是 © o 


target_database 参数 的 存在 是 为 了 让 MIGRATE 75 5 8ق - رز ززم‎ 55, 从 而 可 以 作用 于 
集群 以 外 的 其 他 功能 。 


我 们 对 MIGRATE 命令 做 了 优化 ， 使 得 它 即 使 在 传输 包含 多 个 元 素 的 列表 键 这 样 的 复杂 数据 
时 ， 也 可 以 保持 高 效 。 


不 过 ， 尽管 MIGRATE 非常 高 效 ， 对 一 个 键 非常 多 、 并 且 键 的 数据 量 非常 大 的 集群 来 说 ， 集 
群 重 配置 还 是 会 占用 大 量 的 时 间 ， 可 能 会 导致 集群 没 办 法 适应 那些 对 于 响应 时 间 有 严格 要 求 
的 应 用 程序 。 


ASK لقاع‎ 


在 之 前 介绍 moveo 转向 的 时 候 ， 我 们 说 除了 moveo 转向 之 外 ， 还 有 另 一 种 ask 转向 。 


当 节 点 需要 让 一 个 客户 端 长 期 地 (permanently) 将 针对 某 个 槽 的 命令 请 求 发 送 至 另 一 个 节点 
时 ， 节点 向 客户 端 返 回 moveo 转向 。 


另 一 方面 ， 当 节 点 需要 让 客户 端 仅 仅 在 下 一 个 命令 请 求 中 转向 至 另 一 个 节点 时 ， 节点 向 客户 
端 返回 ask 转向 。 


比如 说 ， 在 我 们 上 一 节 列 举 的 槽 8 的 例子 中 ， AA s 所 包含 的 各 个 键 分 散在 节点 A 和 
节点 8 中 ， 所 以 当 客户 端 在 节点 A 中 没 找到 某 个 键 时 ， 它 应 该 转向 到 节点 B 中 去 寻找 ， 但 
是 这 种 转向 应 该 仅仅 影响 一 次 命令 查询 ， 而 不 是 让 客户 端 每 次 都 直接 去 查找 节点 B : 在 节点 
م‎ 所 持 有 的 属于 槽 8 的 键 没有 全 部 被 迁移 到 节点 B 之 前 ， 客 户 端 应 该 先 访问 节点 A， 然后 
骨 访 问 节点 B 。 

因为 这 种 转向 只 针对 16384 个 槽 中 的 其 中 一 个 槽 ， 所 以 转向 对 集群 造成 的 性 能 损耗 属于 可 

接受 的 范围 。 

因为 上 述 原因 ， 如 果 我 们 要 在 查找 节点 人 之后， 继续 查找 节点 B ， 那么 客户 端 在 向 节点 B 

发 送 命令 请 求 之 前 ， 应 该 先 发 送 一 个 askine 命令 ， 否 则 这 个 针对 带 有 importing 状态 的 

槽 的 命令 请 求 将 被 节点 B 拒绝 执行 。 


接收 到 客户 端 asking 命令 的 节点 将 为 客户 端 设 置 一 个 一 次 性 的 标志 (flag) ， 使 得 客户 端 
可 以 执行 一 次 针对 IMPORTING 状态 的 槽 的 命令 请 求 。 


从 客户 端的 角度 来 看 Ask 转向 的 完整 语义 (semantics) 如 下 : 
٠ 如 果 客 户 端 接收 到 ask 转向 ， 那么 将 命令 请 求 的 发 送 对 象 调 整 为 转向 所 指定 的 节点 。 
٠ 先 发 送 一 个 AskING 命令 ， 然 后 再 发 送 真 正 的 命令 请 求 。 
。 不 必 更 新 客户 端 所 记录 的 槽 8 至 节点 的 映射 : 槽 8 应 该 仍然 映射 到 节点 A， 而 不 是 
节点 B。 


一 旦 节点 A 针 对 槽 8 的 迁移 工作 完成 ， 节点 A 在 再 次 收 到 针对 槽 8 的 命令 请 求 时 ， 就 会 
向 客户 端 返回 moveo 转向 ， HATH s 的 命令 请 求 长 期 地 转向 到 节点 B 。 


注意 ， 即使 客户 端 出 现 Bug , 过 早 地 将 槽 8 映射 到 了 节点 8 上 面 ， 但 只 要 这 个 客户 端 不 
RIE askine 命令 ， 客 户 端 发 送 命令 请 求 的 时 候 就 会 遇 上 MovED 错误 ， 并 将 它 转向 回 节点 
A。 


DSS 
容错 
节点 失效 检测 


以 下 是 节点 失效 检查 的 实现 方法 : 


e 当 一 个 节点 向 另 一 个 节点 发 送 PING 命 舍 ， 但 是 目标 节点 未 能 在 给 定 的 时 限 内 返回 
PING 命令 的 回复 时 ， 那么 发 送 命令 的 节点 会 将 目标 节点 标记 为 ”PFAIL (possible 
failure， 可 能 已 失效 ) 。 


等 待 PING 命令 回复 的 时 限 称 为 “节点 超时 时 限 (node timeout) ”, 是 一 个 节点 选项 
(node-wise setting) 。 


٠ 每 次 当 节 点 对 其 他 节点 发 送 PING 命令 的 时 候 ， 它 都 会 随机 地 广播 三 个 它 所 知道 的 节点 
的 信息 ， 这 些 信息 里 面 的 其 中 一 项 就 是 说 明 节 点 是 否 已 经 被 标记 为 PFAIL 或 者 FAIL 


o 


٠ 当 节 点 接收 到 其 他 节点 发 来 的 信息 时 ， 它 会 记 下 那些 被 其 他 节点 标记 为 失效 的 节点 。 这 
称 为 失效 报告 (failure report) 。 


٠ 如 果 节 点 已 经 料 某 个 节点 标记 为 pra , 并 且 根 据 节 点 所 收 到 的 失效 报告 显 式 ， 集群 
中 的 大 部 分 其 他 主 节 点 也 认为 那个 节点 进入 了 失效 状态 ， 那么 节点 会 将 那个 失效 节点 的 
状态 标记 为 FAIL o 


。 一 且 某 个 节点 被 标记 为 ”FAIL ， 关于 这 个 节点 已 失效 的 信息 就 会 被 广播 到 整个 集群 ， 所 
有 接收 到 这 条 信息 的 节点 都 会 将 失效 节点 标记 为 FAIL o 


简单 来 说 ， 一 个 节点 要 将 另 一 个 节点 标记 为 失效 ， 必须 先 询问 其 他 节点 的 意见 ， 并 且 得 到 大 
部 分 主 节点 的 同意 才 行 。 

因为 过 期 的 失效 报告 会 被 移 除 ， 所 以 主 节点 要 将 某 个 节点 标记 为 FAIL 的 话 ， 必须 以 最 近 接 
收 到 的 失效 报告 作为 根据 。 

在 以 下 两 种 情况 中 ， 节点 的 FAIL 状态 会 被 移 除 : 


٠ 如 果 被 标记 为 FAIL 的 是 从 节点 ， 那么 当 这 个 节点 重新 上 线 时 ， FAIL 标记 就 会 被 移 
除 。 


保持 (retaning) 从 节点 的 FAIL 状态 是 没有 意义 的 ， 因为 它 不 处 理 任何 柳 ， 一 个 从 节 
点 是 否 处 于 FAIL 状态 ， 决 定 了 这 个 从 节点 在 有 需要 时 能 否 被 提升 为 主 节 点 。 


٠ 如 果 一 个 主 节点 被 打上 FAIL 标记 之 后 ， 经 过 了 节点 超时 时 限 的 四 倍 时 间 ， 再 加 上 十 秒 
钟 之 后 ， 针对 这 个 主 节点 的 槽 的 故障 转移 操作 仍 未 完成 ， 并 且 这 个 主 节点 已 经 重新 上 线 
的 话 ， 那么 移 除 对 这 个 节点 的 FAIL 标记 。 


在 第 二 种 情况 中 ， 如 果 故 障 转 移 未 能 顺利 完成 ， 并 且 主 节点 重新 上 线 ， 那么 集群 就 继续 使 用 
原来 的 主 节点 ， 从 而 免 去 管理 员 介 入 的 必要 。 


集群 状态 检测 (已 部 分 实现 ) 


每 当 集群 发 生 配置 变化 时 〈 可 能 是 哈 希 槽 更 新 ， 也 可 能 是 某 个 节点 进入 失效 状态 ) ， 集群 中 
的 每 个 节点 都 会 对 它 所 知道 的 节点 进行 扫描 (scan) 。 


BRB 1. 14 59 ,عد‎ 集群 会 进入 以 下 两 种 状态 的 其 中 一 种 : 


。 FAIL : 集群 不 能 正常 工作 。 当 集 群 中 有 某 个 节点 进入 失效 状态 时 ， 集群 不 能 义理 任何 
命令 请 求 ， 对 于 每 个 命令 请 求 ， 集群 节点 都 返回 错误 回复 。 

。 ok : 集群 可 以 正常 工作 ， 负责 义理 全 部 16384 个 模 的 节点 中 ， 没有 一 个 节点 被 标记 
为 FAIL 状态 。 


这 说 明 即 使 集群 中 只 有 一 部 分 哈 希 槽 不 能 正常 使 用 ， 整个 集群 也 会 停止 处 理 任何 命令 。 


不 过 节点 从 出 现 问题 到 被 标记 为 FAIL 状态 的 这 段 时 间 里 ， 集群 仍然 会 正常 运作 ， 所 以 集群 
在 某 些 时 候 ， 仍然 有 可 能 只 能 义理 针对 16384 个 槽 的 其 中 一 个 子 集 的 命 合 请 求 。 


以 下 是 集群 进入 FAIL 状态 的 两 种 情况 : 


1 至少 有 一 个 哈 希 权 不 可 用 ， 因 为 负责 处 理 这 个 权 的 节点 进入 了 FAIL 状态 
2. a ع‎ 当 大 部 分 主 节点 都 进入 PFAIL 202 集群 也 
进入 FAIL 状态 。 


第 二 个 检查 是 必须 的 ， 因为 要 将 一 个 节点 从 PFAIL 状态 改变 为 FAIL KA, 必须 要 有 大 部 
分 主 节 点 进行 投票 表决 ， 但 是 ， 当 集群 中 的 大 部 分 主 节点 都 进入 失效 状态 时 ， 单 赁 一 个 两 个 
节点 是 没有 办 法 将 一 个 节点 标记 为 FAIL 状态 的 。 


因此 ， 有 了 第 二 lee 条 件 ， 只 要 集群 中 的 大 部 分 主 节点 进入 了 下 线 状 态 ， 那么 集群 就 可 以 


在 不 请 求 这 些 主 9 意见 下 ， 将 某 个 节点 判断 为 FAIL 状态 ， 从 而 让 整个 集群 停止 义理 命 

Disk. 

从 节操 选 举 

anea A FAIL KR, 如 果 这 个 主 节点 有 一 个 或 多 个 从 节点 存在 ， 那么 其 中 一 个 
节点 会 被 升级 为 新 的 主 节点 ， 而 其 他 从 节点 则 会 开始 对 这 个 新 的 主 节 点 进行 复制 。 


新 的 主 节点 由 已 下 线 主 节 点 属 下 的 所 有 从 节点 中 自行 选举 产生 ， 以 下 是 选举 的 条 件 : 


。 这 个 节点 是 已 下 线 主 节 点 的 从 节点 。 

。 已 下 线 主 节点 负责 义理 的 槽 数量 非 空 

。 从 节点 的 数据 被 认为 是 可 靠 的 ， 也 即 是 ， 主 从 节点 之 间 的 复制 连接 (replication link) 的 
断 线 时 长 不 能 超过 节点 超时 时 限 (node timeout) 乘 以 


REDIS_CLUSTER_SLAVE_VALIDITY_MULT 常量 得 出 的 积 。 


如 果 一 个 从 节点 满足 了 以 上 的 所 有 条 件 ， 那么 这 个 从 节点 将 向 集群 中 的 其 他 主 节 点 发 送 授权 
请 求 ， 询问 它们 ， 是 否 允 许 自 己 〈 从 节点 ) 升级 为 新 的 主 节 点 。 


如 果 发 送 授权 请 求 的 从 节点 满足 以 下 属性 ， 那么 主 节点 将 向 从 节点 返回 
FAILOVER_AUTH_GRANTED 授权 ， 同意 从 节点 的 升级 要 求 : 


٠ 发 送 授权 请 求 的 是 一 个 从 节点 ， 并 且 它 所 属 的 主 节点 多 于 FAIL 状态 
٠ 在 已 下 线 主 节点 的 所 有 从 节点 中 ， NALS AOE A ID EBERRON, 
٠ 这 个 从 节点 处 于 正常 的 运行 状态 : 它 没有 被 标记 为 FAIL KA, 也 没有 被 标记 为 


PFAIL 状态 。 
一 旦 某 个 从 节点 在 给 定 的 时 限 内 得 到 大 部 分 主 节点 的 授权 ， 它 就 会 开始 执行 以 下 故障 转移 操 
作 : 


٠ 通过 ponc 数据 包 (packet) 告知 其 他 节点 ， 这 个 节点 现在 是 主 节 点 了 。 
٠ 通过 pons 数据 包 告 知 其 他 节点 ， 这 个 节点 是 一 个 已 升级 的 从 节点 (promoted 


slave) 。 
。 接管 (claiming) 所 有 由 已 下 线 主 节点 负责 处 理 的 哈 希 槽 。 
٠ 显 式 地 向 所 有 节点 广播 一 个 PonG6 数据 包 ， 加 速 其 他 节点 识别 这 个 节点 的 进度 ， 而 不 是 


等 待定 时 的 pING / pons 数据 包 。 
所 有 其 他 节点 都 会 根据 新 的 主 节 点 对 配置 进行 相应 的 更 新 ， 特 别 地 


。 所 有 被 新 的 主 节点 接管 的 槽 会 被 更 新 。 

。 已 下 线 主 节点 的 所 有 从 节点 会 察 党 到 PRoMoTED 标志 ， 并 开始 对 新 的 主 节点 进行 复制 。 

٠ 如 果 已 下 线 的 主 节 点 重新 回 到 上 线 状态 ， 那么 它 会 察觉 到 PRoMoTED 标志 ， 并 将 自身 调 
整 为 现任 主 节 点 的 从 节点 。 


在 集群 的 生命 周期 中 ， 如 果 一 个 带 有 PRoMoTED 标识 的 主 节 点 因为 某 些 原因 转变 成 了 从 节 
点 ， 那么 该 节点 将 丢失 它 所 带 有 的 PROMOTED 标识 。 


发 布 /订阅 (已 实现 ， 但 仍然 需要 改善 ) 


在 一 个 Redis 集群 中 ， 客户 端 可 以 订阅 任意 一 个 节点 ， 也 可 以 向 任意 一 个 节点 发 送信 息 ， 
节点 会 对 客户 端 所 发 送 的 信息 进行 转发 。 


在 目前 的 实现 中 ， 节点 会 将 接收 到 的 信息 广播 至 集群 中 的 其 他 所 有 节点 ， 在 将 来 的 实现 中 ， 
可 能 会 使 用 bloom filter 或 者 其 他 算法 来 优化 这 一 操作 。 


附录 A: CRC16 算法 的 ANSI 实现 参考 


SS 
* 


Copyright 2001-2010 Georges Menie (www.menie.org) 

Copyright 2010 Salvatore Sanfilippo (adapted to Redis coding style) 

All rights reserved. 

Redistribution and use in source and binary forms, with or without 
modification, are permitted provided that the following conditions are met: 


* Redistributions of source code must retain the above copyright 
notice, this list of conditions and the following disclaimer. 
Redistributions in binary form must reproduce the above copyright 
notice, this list of conditions and the following disclaimer in the 
documentation and/or other materials provided with the distribution. 
Neither the name of the University of California, Berkeley nor the 
names of its contributors may be used to endorse or promote products 
derived from this software without specific prior written permission. 


* 


THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY 
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY 
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 


eR UR eR OR الى‎ EO A RL eel AU 1ن كك‎ ee RO MI ال‎ | eee CR ae لو الى‎ A باد‎ 


/* CRC16 implementation acording to CCITT standards. 

* 

* Note by @antirez: this is actually the XMODEM CRC 16 algorithm, using the 
* following parameters: 

* 

* Name : "XMODEM", also known as "ZMODEM", "CRC-16/ACORN" 
* Width : 16 bit 

* Poly : 1021 (That is actually x416 + x12 + x45 + 1) 
* Initialization : 0000 

* Reflect Input byte : False 

* Reflect Output CRC : False 

* Xor constant to output CRC : 0000 

* Output for "123456789" : 3 

wf 


static const uinti6_t crciétab[256]= { 
0x0000, 0x1021, 0x2042, 0x3063, 0x4084, 0x50a5, 0x60c6, Ox70e7, 
0x8108, 0x9129, 0xai4a, Oxb16b, Oxci8c, Oxdiad, Oxeice, Oxfief, 
0x1231, 0x0210, 0x3273, 0x2252, 0x52b5, 04294, 0x72f7, Ox62d6, 


0x9339, 0x8318, 0xb37b, 0xa35a, Oxd3bd, 0xc39c,0xf3ff, Oxe3de, 
0x2462, 0x3443, 0x0420, 0x1401, 0x64e6, 0x74c7, 0x44a4, 0x5485, 
0xa56a, 0xb54b, 0x8528, 0x9509, Oxeb5ee, Oxf5cf, Oxc5ac, Oxd58d, 
0x3653, 0x2672, 0x1611, 0x0630, 0x76d7, Ox66f6, 0x5695, Ox46b4, 
0xb75b, Oxa77a, 0x9719, 0x8738, Oxf7df, Oxe7fe, Oxd79d, Oxc7bc, 
0x48c4, 0x58e5, 0x6886, 0x78a7, 0x0840, 0x1861, 0x2802, 0x3823, 
Oxc9cc, Oxd9ed, Oxe98e, Oxf9af, Ox8948, Ox9969, Oxa90a, Oxb92b, 
Ox5af5, 0x4ad4, Ox7ab7, 0x6a96, Ox1a71, Ox0a50, 0x3a33, 0x2a12, 
Oxdbfd, Oxcbdc, Oxfbbf, Oxeb9e, 0x9b79, Ox8b58, Oxbb3b, Oxabia, 
Ox6ca6, 0x7c87, Ox4ce4, 0x5cc5, 0222622, Ox3c03, 0x0c60, Ox1c41, 
Oxedae, Oxfd8f, Oxcdec, Oxddcd, Oxad2a, OxbdOb, 0x8d68, 0x9d49, 
0x7e97, Ox6eb6, Ox5ed5, Ox4ef4, 0x3e13, Ox2e32, Ox1e51, Ox0e70, 
Oxff9f, Oxefbe, Oxdfdd, Oxcffc, Oxbfib, Oxaf3a, Ox9F59, 0x8f78, 
0x9188, 0x81a9, Oxbica, Oxaieb, Oxd10c, Oxc12d, Oxfi4e, 0xe16f, 
0x1080, 0x00a1, 0x30c2, 07226063, 0x5004, 0x4025, 0x7046, Ox6067, 
0x83b9, 0x9398, Oxa3fb, Oxb3da, Oxc33d, Oxd31c, 0xe37f, Oxf35e, 
0x02b1, 0x1290, 0x22f3, 0x32d2, 0x4235, 0x5214, 0x6277, Ox7256, 
Oxb5ea, Oxa5cb, 0x95a8, 0x8589, Oxf56e, Oxe54f, Oxd52c, Oxc50d, 
0x34e2, 0x24c3, 0x14a0, 0x0481, 0x7466, 0x6447, 0x5424, 0x4405, 
Oxa7db, Oxb7fa, 0x8799, 0x97b8, Oxe75f, OxF77e, Oxc71d, Oxd73c, 
0x26d3, 0x36f2, 0x0691, Ox16b0, 0x6657, 0x7676, 0x4615, 0x5634, 
Oxd94c, Oxc96d, Oxf 90e, Oxe92F, Ox99C8, Ox89e9, Oxb98a, OxaVab, 
0x5844, 0x4865, 0x7806, 0x6827, Ox18C0, 0x08e1, 0x3882, 0x28a3, 
Oxcb7d, Oxdb5c, Oxeb3f, Oxfbie, Ox8bf9, Ox9bd8, Oxabbb, Oxbb9a, 
0x4a75, 0x5a54, 0x6a37,0x7a16, OxOaf1, Ox1adO, Ox2ab3, 023392 , 
Oxfd2e, OxedOf, Oxdd6c, Oxcd4d, Oxbdaa, Oxad8b, 0x9de8, Ox8dc9, 
0x7C26, 026607 , 0x5c64, 0x4c45, 0223632, 02283, 0x1ce0, 0x0cc1, 
Oxefif, Oxff3e, Oxcf5d, Oxdf7c, Oxaf9b, Oxbfba, Ox8Fd9, Ox9ff8, 
0x6e17, 0x7e36, 0x4e55, 0x5e74, 0x2e93, Ox3eb2, OxOed1, Ox1efO 


}; 


uint16_t crci6(const char *buf, int len) { 
int counter; 
uint16 t cre O; 
for (counter 0; counter < len; counter++) 
cre = (crc<<8) ^ crci6tab[((crc>>8) ^ *buf++)&0x00FF]; 
return crc; 


Key 〈 键 ) 


DEL 


DEL key [key ...] 

删除 给 定 的 一 个 或 多 个 key o 

不 存在 的 key 会 被 忽略 。 

可 用 版 本 : 

>= 1.0.0 

A ARAB : 

O(N), n 为 被 删除 的 key AYRE, MPRA TERRA key ， 时 间 复 厅 度 为 O(1)。 删 


除 单个 列表 、 集 合 、 有 序 集合 或 哈 希 表 类 型 的 key ， 时 间 复 杂 度 为 O(M)， Mm 为 以 上 数据 
结构 内 的 元 素数 量 。 


返回 值 : 
被 删除 key 的 数量 。 


# ”删除 单个 key 


redis> SET name huangz 
OK 


redis> DEL name 
(integer) 1 


# 删除 一 个 不 存在 的 key 


redis> EXISTS phone 
(integer) 0 


redis> DEL phone # 失败 ， 没 有 key 被 删除 
(integer) 0 


# 同时 删除 多 个 key 


redis> SET name "redis" 
OK 


redis> SET type "key-value store" 
OK 


redis> SET website "redis.com" 
OK 


redis> DEL name type website 
(integer) 3 


DUMP 


DUMP key 


序列 化 给 定 key ， 并 返回 被 序列 化 的 值 ， 使 用 RESTORE 命令 可 以 将 这 个 值 反 序 列 化 为 
Redis 键 。 


序列 化 生成 的 值 有 以 下 几 个 特点 : 


。 CRA 64 位 的 校 验 和 ， 用 于 检测 错误 ， RESTORE 在 进行 反 序列 化 之 前 会 先 检查 校 验 
和 。 

。 值 的 编码 格式 和 RDB 文件 保持 一 致 。 

。 RDB 版 本 会 被 编码 在 序列 化 值 当中 ， 如 果 因 为 Redis 的 版 本 不 同 造成 RDB 格式 不 兼 
Z, MA Redis 会 拒绝 对 这 个 值 进 行 反 序列 化 操作 。 


序列 化 的 值 不 包括 任何 生存 时 间 信 息 。 
可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 


查找 给 定 键 的 复杂 度 为 O(1) ， 对 键 进行 序列 化 的 复杂 度 为 O(N*M) ， 其 中 N 是 构成 key 的 
Redis 对 象 的 数量 ， 而 M 则 是 这 些 对 象 的 平均 大 小 。 如 果 序 列 化 的 对 象 是 比较 小 的 字符 串 ， 
那么 复 条 度 为 O(1) 。 


返回 值 : 
如 果 key PEE, PARE nil 。 否 则 ， 返 回 序列 化 之 后 的 值 。 


redis> SET greeting "hello, dumping world!" 
OK 


redis> DUMP greeting 
"\x00\x15hello, dumping world! \x06\xO0E\xa0Z\x82\xd8r\xc1\xde" 


redis> DUMP not-exists-key 
(nil) 


EXISTS 


EXISTS key 

检查 给 定 key 是 否 存在 。 
可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 


若 key 存在 ， 返 回 1 ， 否 则 返回 © 。 


redis> SET db "redis" 
OK 


redis> EXISTS db 
(integer) 1 


redis> DEL db 
(integer) 1 


redis> EXISTS db 
(integer) 0 


EXPIRE 


EXPIRE key seconds 
为 给 定 ky 设置 生存 时 间 ， 当 key 过 期 时 (生存 时 间 为 6 )， 它 会 被 自动 删除 。 
在 Redis 中 ， 带 有 生存 时 间 的 key 被 称 为 『 易 失 的 」 (volatile)。 


生存 时 间 可 以 通过 使 用 DEL 命令 来 删除 整个 key KBR, RAR SET 和 GETSET 7 
写 (overwrite)， 这 意味 着 ， 如 果 一 个 命 合 只 是 修改 (alter) 一 个 带 生 存 时 间 的 key 的 值 而 不 是 
用 一 个 新 的 ky 值 来 代替 (replace) 它 的 话 ， 那 么 生存 时 间 不 会 被 改变 。 


比如 说 ， 对 一 个 key 执行 JINCR 命令 ， 对 一 个 列表 进行 LPUSH 命 合 ， 或 者 对 一 个 哈 希 表 执 
行 HSET 命令 ， 这 类 操作 都 不 会 修改 ky 本 身 的 生存 时 间 。 


另 一 方面 ， 如 果 使 用 RENAME 对 一 个 key 进行 改名 ， 那 么 改名 后 的 key 的 生存 时 间 和 改 
名 前 一 样 。 


RENAME 命 命 的 另 一 种 可 能 是 ， 尝 试 将 一 个 带 生存 时 间 的 key 改名 成 另 一 个 带 生存 时 间 的 
another_key ， 这 时 旧 的 another_key (以 及 它 的 生存 时 间 ) 会 被 删除 ， 然 后 旧 的 key RA 
名 为 another_key ， Atk, 新 的 another_key 的 生存 时 间 也 和 原本 的 key 一 样 。 


使 用 PERSIST 命令 可 以 在 不 删除 key 的 情况 下 ， 移 除 key 的 生存 时 间 ， 让 key 重新 成 
为 一 个 『 持 久 的 J (persistent) key o 


更 新 生存 时 间 


可 以 对 一 个 已 经 带 有 生存 时 间 的 key 执行 EXPIRE 命令 ， 新 指定 的 生存 时 间 会 取代 旧 的 生 
存 时 间 。 


过 期 时 间 的 精确 度 


在 Redis 2.4 版 本 中 ， 过 期 时 间 的 延迟 在 1 秒 钟 之 内 一 一 也 即 是 ， 就 算 key 已 经 过 期 但 
它 还 是 可 能 在 过 期 之 后 一 秒 钟 之 内 被 访问 到 ， 而 在 新 的 Redis 2.6 版 本 中 ， 延 迟 被 降低 到 1 2 
秒 之 内 。 


Redis 2.1.3 之 前 的 不 同 之 处 


在 Redis 2.1.3 之 前 的 版 本 中 ， 修 改 一 个 带 有 生存 时 间 的 key 会 导致 整个 key 被 删除 ， 这 
一 行为 是 受 当时 复制 (replication) 层 的 限制 而 作出 的 ， 现 在 这 一 限制 已 经 被 修复 。 


可 用 版 本 : 
>= 1.0.0 


THERE: 


ERDRE 1 。 当 ky 不 存在 或 者 不 能 为 key 设置 生存 时 间 时 (比如 在 低 于 2.1.3 版 本 
的 Redis 中 你 党 试 更 新 key 的 生存 时 间 )， 返 回 8 。 


redis> SET cache_page "www.google.com" 
OK 


redis> EXPIRE cache_page 30 # 设置 过 期 时 间 为 30 W 
(integer) 1 


redis> TTL cache_page # 查看 剩余 生存 时 间 
(integer) 3 


redis> EXPIRE cache_page 30000 # 更 新 过 期 时 间 
(integer) 1 


redis> TTL cache_page 
(integer) 29996 


模式 : 导航 会 话 


假设 你 有 一 项 web 服务 ， 打 算 根 据 用 户 最 近 访 问 的 N 个 页 面 来 进行 物品 推荐 ， 并 且 假 设 用 
停止 阅览 超过 60 秒 ， 那 么 就 清空 阅览 记录 (为 了 减少 物品 推荐 的 计算 量 ， و‎ 
的 新 鲜 度 )。 


这 些 最 近 访 问 的 页 面 记 录 ， 我 们 称 之 为 『 导 航 会 话 上 (Navigation session), ALAR /NCR 和 
RPUSH ARE Redis 中 实现 它 : 每 当 用 户 阅览 一 个 网 页 的 时 候 ， 执 行 以 下 代码 : 


MULTI 
RPUSH pagewviews.user:<userid> http://..... 
EXPIRE pagewviews.user:<userid> 60 

EXEC 


如 果 用 户 停止 阅览 超过 60 秒 ， 那 么 它 的 导航 会 话 就 会 被 清空 ， 当 用 户 重新 开始 阅览 的 时 候 ， 
系统 又 会 重新 记录 导航 会 话 ， 继续 进 行 物品 推荐 。 


EXPIREAT 


EXPIREAT key timestamp 

EXPIREAT 的 作用 和 EXPIRE 类 似 ， 都 用 于 为 key 设置 生存 时 间 。 

不 同 在 于 EXPIREAT 命令 接受 的 时 间 参 数 是 UNIX 时 间 惟 (unix timestamp). 

可 用 版 本 : 

>= 1.2.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

如 果 生 存 时 间 设 置 成 功 ， 返 回 1 。 当 key 不 存在 或 没 办 法 设置 生存 时 间 ， 返 回 o 。 


redis> SET cache www.google.com 
OK 


redis> EXPIREAT cache 1355292000 # 这 个 key 将 在 2012.12.12 过 期 
(integer) 1 


redis> TTL cache 
(integer) 45081860 


KEYS 


KEYS pattern 
查找 所 有 符合 给 定 模式 pattern 的 key o 


keys * 匹配 数据 库 中 所 有 key 。 KEYS h?llo 匹配 hello , hallo 和 hxllo 
等 。 KEYS h*llo 匹配 hilo 和 heeeeello $, KEYS h[ae]llo 匹配 hello 和 hallo ， 但 
不 匹配 hillo 。 


特殊 符号 用 \、 陋 开 
Warning 


KEYS 的 速度 非常 快 ， 但 在 一 个 大 的 数据 库 中 使 用 它 仍然 可 能 造成 性 能 问题 ， 如 果 你 需要 从 
一 个 数据 集中 查找 特定 的 key ， 你 最 好 还 是 用 Redis 的 集合 结构 (set) 来 代 蔡 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N), n 为 数据 库 中 key 的 数量 。 
返回 值 : 

符合 给 定 模 式 的 key 列表 。 


redis> MSET one 1 two 2 three 3 four 4 # 一 次 设置 4 个 key 
OK 


redis> KEYS *o* 
1) "four" 
2) "two" 
3) "one" 


redis> KEYS t?? 
1) "two" 


redis> KEYS t[w]* 
1) "two" 


redis> KEYS * # 匹配 数据 库 内 所 有 key 
1) "four" 

2) "three" 

3) "two" 

4) "one" 


MIGRATE 


MIGRATE host port key destination-db timeout [COPY] [REPLACE] 


将 key 原子 性 地 从 当前 实例 传送 到 目标 实例 的 指定 数据 库 上 ， 一 旦 传送 成 功 ， key 保证 会 
出 现在 目标 实例 上 ， 而 当前 实例 上 的 key 会 被 删除 。 


这 个 命令 是 一 个 原子 操作 ， 它 在 执行 的 时 候 会 阻塞 进行 迁移 的 两 个 实例 ， 直 到 以 下 任意 结果 
RE: 迁移 成 功 ， 迁 移 失 败 ， 等 到 超时 。 


命令 的 内 部 实现 是 这 样 的 : 它 在 当前 实例 对 给 定 key 执行 DUMP RA, HERI, Aa 
传送 到 目标 实例 ， 目 标 实 例 再 使 用 RESTORE 对 数据 进行 反 序列 化 ， 并 将 反 序列 化 所 得 的 数 
据 添 加 到 数据 库 中 ; 当前 实例 就 像 目 标 实 例 的 客户 端 那 样 ， 只 要 看 到 RESTORE 命令 返回 
ok ， 它 就 会 调用 DEL 删除 自己 数据 库 上 的 key o 


timeout 参数 以 毫秒 为 格式 ， 指 定 当 前 实例 和 目标 实例 进行 沟通 的 最 大 间隔 时 间 。 这 说 明 操 
作 并 不 一 定 要 在 timeout 毫秒 内 完成 ， 只 是 说 数据 传送 的 时 间 不 能 超过 这 个 timeout 数 。 


MIGRATE 命令 需要 在 给 定 的 时 间 规定 内 完成 IO 操作。 如 果 在 传送 数据 时 发 生 IO 错误 ， 或 
者 达到 了 超时 时 间 ， 那 么 命令 会 停止 执行 ， 并 返回 一 个 特殊 的 错误 : I0ERR o 


IoERR 出 现时 ， 有 以 下 两 种 可 能 :‏ فك 


» key 可 能 存在 于 两 个 实例 
© key 可 能 只 存在 于 当前 实例 


唯一 不 可 能 发 生 的 情况 就 是 丢失 key ， 因 此 ， 如 果 一 个 客户 端 执行 MIGRATE AD, FAA 
幸 遇 上 I0ERR 错误 ， 那 么 这 个 客户 端 唯一 要 做 的 就 是 检查 自己 数据 库 上 的 key 是 否 已 经 被 
正确 地 删除 。 


如 果 有 其 他 错误 发 生 ， 那 么 MIGRATE 保证 key 只 会 出 现在 当前 实例 中 。 (当然 ， 目 标 实例 
的 给 定数 据 库 上 可 能 有 和 key 同名 的 键 ， 不 过 这 和 MIGRATE 命令 没有 关系 ) 。 


可 选项 : 


e copy : 不 移 除 源 实例 上 的 key o 
e REPLACE : 替换 目标 实例 上 已 存在 的 key o 


可 用 版 本 : 
>= 2.6.0 


THERE: 


5 


这 个 命令 在 源 实 例 上 实际 执行 DUMP 命令 和 DEL 命令 ， 在 目标 实例 执行 RESTORE RS 
EH 


查看 以 上 命令 的 文档 可 以 看 到 详细 的 复 末 度 说 明 。 key 数据 在 两 个 实例 之 间 传 输 的 复杂 
O(N) 。 


返回 值 : 


迁移 成 功 时 返回 ok ， 否 则 返回 相应 的 错误 。 


示例 
先 启 动 两 个 Redis 实例 ， 一 个 使 用 默认 的 6379 端口 ， 一 个 使 用 7777 端口 。 


$ ./redis-server & 
[1] 3557 


$ ./redis-server --port 7777 & 
[2] 3560 


然后 用 客户 端 连 上 6379 端口 的 实例 ， 设 置 一 个 键 ， 然 后 将 它 迁 移 到 7777 端口 的 实例 上 : 


$ ./redis-cli 


redis 127.0.0.1:6379> flushdb 
OK 


redis 127.0.0.1:6379> SET greeting "Hello from 6379 instance" 
OK 


redis 127.0.0.1:6379> MIGRATE 127.0.0.1 7777 greeting 0 1000 
OK 


redis 127.0.0.1:6379> EXISTS greeting # 迁移 成 功 后 key 被 删除 
(integer) 0 


使 用 另 一 个 客户 端 ， 查 看 7777 端口 上 的 实例 : 


$ ./redis-cli -p 7777 


redis 127.0.0.1:7777> GET greeting 
"Hello from 6379 instance" 


MOVE 


MOVE key db 
将 当前 数据 库 的 key 移动 到 给 定 的 数据 库 db 当中 。 


如 果 当 前 数据 库 ( 源 数据 库 ) 和 给 定数 据 库 (目标 数据 库 ) 有 相同 名 字 的 给 定 key ， 或 者 key 不 
存在 于 当前 数据 库 ， 那 么 move 没有 任何 效果 。 


因此 ， 也 可 以 利用 这 一 特性 ， 将 MOVE 当 作 锁 (locking) 原 语 (primitive)。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

移动 成 功 返 回 1 ， 失 败 则 返回 o 。 


# key 存在 于 当前 数据 库 


redis> SELECT 0 # redis 默 认 使 用 数据 库 96， 为 了 清晰 起 见 ， 这 里 再 显 式 指 久 
OK 


redis> SET song "secret base - Zone" 


OK 

redis> MOVE song 1 # كلا‎ song 移动 到 数据 库 1 

(integer) 1 

redis> EXISTS song # Song 已 经 被 移 走 

(integer) 0 

redis> SELECT 1 # 使 用 数据 库 1 

OK 

redis:1> EXISTS song # 证 实 song 被 移 到 了 数据 库 1 (注意 命令 提示 符 变 成 了 " 


(integer) 1 
# 当 key 不 存在 的 时 候 


redis:1> EXISTS fake_key 
(integer) 0 


redis:1> MOVE fake_key 0 # 试图 从 数据 库 1 移动 一 个 不 存在 的 key 到 数据 库 0, 4 
(integer) 0 

redis:1> select 0 # 使 用 数据 库 0 

OK 

redis> EXISTS fake_key # 证 实 fake_key 不 存在 


(integer) 0 


# 当 源 数据 库 和 目标 数据 库 有 相同 的 key 时 


redis> SELECT 0 # 使 用 数据 库 0 

OK 

redis> SET favorite fruit "banana" 

OK 

redis> SELECT 1 # 使 用 数据 库 1 

OK 

redis:1> SET favorite_fruit "apple" 

OK 

redis:1> SELECT 0 # 使 用 数据 库 9， 并 试图 将 favorite_fruit 移动 到 数据 局 
OK 

redis> MOVE favorite_fruit 1 # 因为 两 个 数据 库 有 相同 的 key, MOVE Km 
(integer) 0 

redis> GET favorite fruit # 数据 库 0 的 favorite_fruit 没 变 
"banana" 


redis> SELECT 1 
OK 


redis:1> GET favorite fruit # 数据 库 1 的 favorite_fruit 也 是 
"apple" 





OBJECT 


OBJECT subcommand [arguments [arguments]] 
OBJECT 命令 允 许 从 内 部 察看 给 定 key 的 Redis 对 象 。 


它 通常 用 在 除 错 (debugging) 或 者 了 解 为 了 节省 空间 而 对 key 使 用 特殊 编码 的 情况 。 当 将 
Redis 用 作 缓 存 程序 时 ， 你 也 可 以 通过 OBJECT 命令 中 的 信息 ， 决 定 key 的 驱逐 策略 
(eviction policies), 


OBJECT 命 合 有 多 个 子 命 全 : 


© OBJECT REFCOUNT &lt;key&gt; 返回 给 定 key 引用 所 储存 的 值 的 次 数 。 此 命令 主要 用 于 
除 错 。 

٠ OBJECT ENCODING &lt;key&gt; 返回 给 定 key 锁 储存 的 值 所 使 用 的 内 部 表示 
(representation)。 

© OBJECT IDLETIME &lt;key&gt; 返回 给 定 key 自 储存 以 来 的 空闲 时 间 (idle， 没有 被 读 取 
也 没有 被 写 入 )， 以 秒 为 单位 。 对 象 可 以 以 多 种 方式 编码 : 


。 字符 串 可 以 被 编码 为 raw (一 般 字符 串 ) 或 int (为 了 节约 内 存 ，Redis 会 将 字符 串 表 示 


的 64 位 有 符号 整数 编码 为 整数 来 进行 储存 ) 。 
e 列表 可 以 被 编码 为 ziplist 或 linkedlist 。 ziplist 是 为 节约 大 小 较 小 的 列表 空间 
而 作 的 特殊 表示 。 
٠ 集合 可 以 被 编码 为 intset 或 者 hashtable > intset 是 只 储存 数字 的 小 集合 的 特殊 表 
示 。 
٠ 哈 希 表 可 以 编码 为 zipmap 或 者 hashtable 。 zipmap 是 小 哈 希 表 的 特殊 表示 。 
٠ 有 序 集合 可 以 被 编码 为 ziplist 或 者 skiplist 格式 。 ziplist 用 于 表示 小 的 有 序 集 
合 ， 而 skiplist 则 用 于 表示 任何 大 小 的 有 序 集合 。 假 如 你 做 了 什么 让 Redis 没 办 法 再 


使 用 节省 空间 的 编码 时 (比如 将 一 个 只 有 1 个 元 素 的 集合 扩展 为 一 个 有 100 万 个 元 素 的 集 


合 )， 特 殊 编 码 类 型 (specially encoded types) 会 自动 转换 成 通用 类 型 (general type)。 
可 用 版 本 : 
>= 2.2.3 


at a] RAE: 


REFCOUNT 和 IDLETIME 返回 数字 。 ENcopIN6 返回 相应 的 编码 类 型 。 


redis> SET game "COD" # 设置 一 个 字符 串 


OK 
redis> OBJECT REFCOUNT game # 只 有 一 个 引用 

(integer) 1 

redis> OBJECT IDLETIME game # 等 待 一 阵 。。。 然 后 查看 空间 时 间 
(integer) 90 

redis> GET game # 提取 game， 让 它 处 于 活跃 (active) 状 态 
"Cop" 

redis> OBJECT IDLETIME game # 不 再 处 于 空闲 状态 

(integer) 0 

redis> OBJECT ENCODING game # 字符 串 的 编码 方式 

"raw" 


redis> SET big-number 23102930128301091820391092019203810281029831092 # 非常 长 的 数字 会 被 编 石 
OK 


redis> OBJECT ENCODING big-number 
"raw" 


redis> SET small-number 12345 # 而 短 的 数字 则 会 被 编码 为 整数 
OK 


redis> OBJECT ENCODING small-number 
Da g 


E| E 





PERSIST 


PERSIST key 


移 除 给 定 key 的 生存 时 间 ， 将 这 个 key 从 『 易 失 的 」( 带 生存 时 间 key ) 转 换 成 『 持 久 
的 」( 一 个 不 带 生存 时 间 、 永 不 过 期 的 key )。 


可 用 版 本 : 

>= 2.2.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

当 生 存 时 间 移 除 成 功 时 ， 返 回 1 .如 果 key 不 存在 或 key 没有 设置 生存 时 间 ， 返 回 © 。 


redis> SET mykey "Hello" 
OK 


redis> EXPIRE mykey 10 # 为 key 设置 生存 时 间 
(integer) 1 


redis> TTL mykey 
(integer) 10 


redis> PERSIST mykey # BIR key 的 生存 时 间 
(integer) 1 


redis> TTL mykey 
(integer) -1 


PEXPIRE 


PEXPIRE key milliseconds 


这 个 命令 和 EXPIRE 命令 的 作用 类 似 ， 但 是 它 以 宫 秒 为 单位 设置 key 的 生存 时 间 ， 而 不 像 
EXPIRE 命令 那样 ， 以 秒 为 单位 。 


可 用 版 本 : 
>= 0 


时 间 复 杂 度 : 


设置 成 功 ， 返 回 1``key 不 存在 或 设置 失败 ， 返 回 o 


redis> SET mykey "Hello" 
OK 


redis> PEXPIRE mykey 1500 
(integer) 1 


redis> TTL mykey # TTL 的 返回 值 以 秒 为 单位 
(integer) 2 


redis> PTTL mykey # PTTL 可 以 给 出 准确 的 毫秒 数 
(integer) 1499 


PEXPIREAT 


PEXPIREAT key milliseconds-timestamp 


这 个 命令 和 EXPIREAT BREW, BELEZA AMAA key 的 过 期 unix ae, MAE 
像 EXPIREAT 那样 ， 以 秒 为 单位 。 


可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

如 果 生 存 时 间 设 置 成 功 ， 返 回 1 。 当 ky 不 存在 或 没 办 法 设置 生存 时 间 时 ， 返 回 6 。( 查 


看 EXPIRE 命令 获取 更 多 信息 ) 


redis> SET mykey "Hello" 
OK 


redis> PEXPIREAT mykey 1555555555005 
(integer) 1 


redis> TTL mykey # TTL 返回 秒 
(integer) 223157079 


redis> PTTL mykey # PTTL 返回 毫秒 
(integer) 223157079318 


PTTL 


PTTL key 


这 个 命令 类 似 于 TTL 命令 ， 但 它 以 毫秒 为 单位 返回 key 的 剩余 生存 时 间 ， 而 不 是 像 TTL 命 
兮 那 样 ， 以 秒 为 单位 。 


可 用 版 本 : 
>= 2.6.0 
SRE: 


O(1) 


key 不 存在 时 ，‏ كك 
则 ， 以 毫秒 为 单位 ，‏ 


-2 。 当 key 存在 但 没有 设置 剩余 生存 时 间 时 ， 返 回 -1 。 
回 key 的 剩余 生存 时 间 。 


| 


返回 
WR 


Note 


在 Redis 2.8 LAB, 4 key 不 存在 ， 或 者 key 没有 设置 剩余 生存 时 间 时 ， 命 令 都 返回 -1 


o 


# 不 存在 的 key 


redis> FLUSHDB 
OK 


redis> PTTL key 
(integer) -2 


# key 存在 ， 但 没有 设置 剩余 生存 时 间 


redis> SET key value 
OK 


redis> PTTL key 
(integer) -1 


# 有 剩余 生存 时 间 的 key 


redis> PEXPIRE key 10086 
(integer) 1 


redis> PTTL key 
(integer) 6179 


RANDOMKEY 


RANDOMKEY 

从 当前 数据 库 中 随机 返回 (不 删除 ) 一 个 key 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

当 数 据 库 不 为 空 时 ， 返 回 一 个 key 。 当 数据 库 为 空 时 ， 返 回 nil o 


# 数据 库 不 为 空 


redis> MSET fruit "apple" drink "beer" food "cookies" # 设置 多 个 key 
OK 


redis> RANDOMKEY 
"fruit" 


redis> RANDOMKEY 
"Food" 


redis> KEYS * # 查看 数据 库 内 所 有 key， 证 明 RANDOMKEY 并 不 删除 key 
1) "food" 
2) "drink" 
3) "fruit" 


# 数据 库 为 空 


redis> FLUSHDB # 删除 当前 数据 库 所 有 key 
OK 


redis> RANDOMKEY 
(nil) 


RENAME 


RENAME key newkey 

将 key 改名 为 newkey o 

key 和 newkey 相同 ， 或 者 key 不 存在 时 ， 返 回 一 个 错误 。‏ كك 
newkey 已 经 存在 时 ， RENAME 命令 将 覆盖 旧 值 。‏ كك 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

改名 成 功 时 提示 ok ， 人 失败 时 候 返 回 一 个 错误 。 


# key 存在 且 newkey 不 存在 


redis> SET message "hello world" 
OK 


redis> RENAME message greeting 
OK 


redis> EXISTS message # message 不 复 存 在 
(integer) 0 


redis> EXISTS greeting # greeting 取而代之 
(integer) 1 


# 当 key 不 存在 时 ， 返 回 错误 


redis> RENAME fake_key never_exists 
(error) ERR no such key 


# newkey 已 存在 时 ， RENAME 会 覆盖 旧 newkey 


redis> SET pc "lenovo" 
OK 


redis> SET personal_computer "dell" 
OK 


redis> RENAME pc personal_computer 


OK 

redis> GET pc 

(nil) 

redis:1> GET personal_computer # 原来 的 值 dell 被 覆盖 了 


"lenovo" 


RENAMENX 


RENAMENX key newkey 

当 且 仅 当 newkey 不 存在 时 ， 将 key 改名 为 newkey o 

key 不 存在 时 ， 返 回 一 个 错误 。‏ كك 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

修改 成 功 时 ， 返 回 1 。 如 果 newkey 已 经 存在 ， 返 回 o 。 


# newkey 不 存在 ， 改 名 成 功 


redis> SET player "MPlyaer" 
OK 


redis> EXISTS best_player 
(integer) 0 


redis> RENAMENX player best_player 
(integer) 1 


#_newkey 存 在 时 ， 失 败 


redis> SET animal "bear" 
OK 


redis> SET favorite_animal "butterfly" 
OK 


redis> RENAMENX animal favorite_animal 
(integer) 0 


redis> get animal 
"bear" 


redis> get favorite_animal 
"butterfly" 


RESTORE 


RESTORE key ttl serialized-value [REPLACE] 
反 序 列 化 给 定 的 序列 化 值 ， 并 将 它 和 给 定 的 key KK 
参数 ttl 以 毫秒 为 单位 为 key 设置 生存 时 间 ; 如 果 ttl 为 。 ， 那 么 不 设置 生存 时 间 。 


RESTORE 在 执行 反 序 列 化 之 前 会 先 对 序列 化 值 的 RDB 版 本 和 数据 校 验 和 进行 检查 ， 如 果 
RDB 版 本 不 相同 或 者 数据 不 完整 的 话 ， 那 么 RESTORE 会 拒绝 进行 反 序 列 化 ， 并 返回 一 个 错 


误 。 


如 果 键 key 已 经 存在 ， 并 且 给 定 了 REPLACE 选项 ， 那么 使 用 反 序 列 化 得 出 的 值 来 代替 键 
key 原 有 的 值 ; 相反 地 ， 如 果 键 key 已 经 存在 ， 但 是 没有 给 定 REPLACE 选项 ， 那么 命 


令 返 回 一 个 错误 。 

更 多 信息 可 以 参考 DUMP 18 
可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 


查找 给 定 键 的 复杂 度 为 O(1) ， 对 键 进行 反 序列 化 的 复 厅 度 为 O(N/M) ， 其 中 N 是 构成 key 
的 Redis 对 象 的 数量 ， 而 M 则 是 这 些 对 象 的 平均 大 小 。 有 序 集合 (sorted set) 的 反 序 列 化 复杂 
度 为 O(NM*log(N)) ， 因 为 有 序 集合 每 次 插入 的 复杂 度 为 O(log(N)) 。 如 果 反 序列 化 的 对 象 是 
比较 小 的 字符 串 ， 那 么 复 末 度 为 O(1) 。 

返回 值 : 


如 果 反 序列 化 成 功 那 么 返回 ok ， 否 则 返回 一 个 错误 。 


# 创建 一 个 键 ， 作 为 DUMP 命令 的 输入 


redis> SET greeting "hello, dumping world!" 
OK 


redis> DUMP greeting 
"\xOO\x15hello, dumping world! \x06\xO0E\xa0Z\x82\xd8r\xc1\xde" 


# 将 序列 化 数据 RESTORE 到 另 一 个 键 上 面 


redis> RESTORE greeting-again 0 "\x00\x15hello, dumping world! 06002221 
OK 


redis> GET greeting-again 
"hello, dumping world!" 


# 在 没有 给 定 REPLACE 选项 的 情况 下 ， 再 次 尝试 反 序列 化 到 同一 个 键 ， 失 败 


redis> RESTORE greeting-again © "\x00\x15hello, dumping world! 060022021 
(error) ERR Target key name is busy. 


# 给 定 REPLACE 选项 ， 对 同一 个 键 进行 反 序 列 化 成 功 


redis> RESTORE greeting-again © "\x00\x15hello, dumping world! 060022021 
OK 


# 尝试 使 用 无 效 的 值 进行 反 序列 化 ， 出 错 


redis> RESTORE fake-message 0 "hello moto moto blah blah" 
(error) ERR DUMP payload version or checksum are wrong 


ap 





SORT 


SORT key [BY pattern] [LIMIT offset count] [GET pattern [GET pattern ...]] [ASC | 


DESC] [ALPHA] [STORE destination] 
返回 或 保存 给 定 列表 、 和 集合、 有 序 集合 key 中 经 过 排序 的 元 素 。 
排序 默认 以 数字 作为 对 象 ， 值 被 解释 为 双 精 度 浮 点 数 ， 然 后 进行 比较 。 


一 般 SORT 用 法 


最 简单 的 SORT 使 用 方法 是 sort key 和 SORT key DESC 


© sort key 返回 键 值 从 小 到 大 排序 的 结果 。 
e SORT key besc 返回 键 值 从 大 到 小 排序 的 结果 。 


假设 today_cost 列表 保存 了 今日 的 开销 金额 ， 那么 可 以 用 SORT 命令 对 它 进 行 排序 : 


# 开销 金额 列表 


redis> LPUSH today_cost 30 1.5 10 8 
(integer) 4 

# 排序 

redis> SORT today_cost 

1) on 

2) "gu 

3) "476" 

4) "30" 

# RHE 

redis 127.0.0.1:6379> SORT today_cost DESC 
1) "30" 

2) "46" 

3) "ngu 

4( SY 


使 用 ALPHA 修饰 符 对 字符 串 进行 排序 


因为 SORT 命令 默认 排序 对 象 为 数字 ， 当 需 要 对 字符 串 进行 排序 时 ， 
命令 之 后 添加 aH 修饰 符 : 


需要 显 式 地 在 SORT 


# 网 址 


redis> LPUSH website "www.reddit.com" 
(integer) 1 


redis> LPUSH website "www.slashdot.com" 
(integer) 2 


redis> LPUSH website "www. infoq.com" 
(integer) 3 


# 默认 GRE) 排序 

redis> SORT website 

1) "www. infoq.com" 

2) "www.slashdot.com" 

3) "www.reddit.com" 

# 按 字符 排序 

redis> SORT website ALPHA 
1) "www. infoq.com" 


2) "www.reddit.com" 
3) "www.slashdot.com" 


如 果 系 统 正确 地 设置 了 Lc_coLLATE 环境 变量 的 话 ，Redis 能 识别 UTF-8 编码 。 


使 用 LIMIT 修饰 符 限制 返回 结果 


排序 之 后 返回 元 素 的 数量 可 以 通过 LIMIT 侈 饰 符 进行 限制 ， 修饰 符 接 受 offset 和 count 
两 个 参数 : 


@ offset 指定 要 跳 过 的 元 素数 量 。 
e count 指定 跳 过 offset 个 指定 的 元 素 之 后 ， 要 返回 多 少 个 对 象 。 


以 下 例子 返回 排序 结果 的 前 5 个 对 象 ( offset 为 6 表示 没有 元 素 被 跳 过 )。 


# 添加 测试 数据 ， 列 表 值 为 1 指 10 


redis 127.0.0.1:6379> RPUSH rank 1 3 5 7 9 
(integer) 5 


redis 127.0.0.1:6379> RPUSH rank 2 4 6 8 10 
(integer) 10 


# 返回 列表 中 最 小 的 5 Ma 


redis 127.0.0.1:6379> SORT rank LIMIT 0 5 


1( Wau 
2) wo 
3) ngu 
4) wan 
5) nou 


可 以 组 合 使 用 多 个 修饰 符 。 以 下 例子 返回 从 大 到 小 排序 的 前 5 个 对 象 。 


redis 127.0.0.1:6379> SORT rank LIMIT © 5 DESC 

1) "40" 

2) "g" 

3) "g" 
"u7" 
ng" 


使 用 外 部 key 进行 排序 


可 以 使 用 外 部 key 的 数据 作为 权重 ， 代 蔡 默 认 的 直接 对 比 键 值 的 方式 来 进行 排序 。 
假设 现在 有 用 户 数据 如 下 : 


uid username{uid} userlevel{uid} 
1 admin 9999 
2 jack 10 
3 peter 25 
4 mary 70 


以 下 代码 将 数据 输入 到 Redis 中 : 


# admin 


redis 127.0.0.1:6379> LPUSH uid 1 
(integer) 1 


redis 127.0.0.1:6379> SET user_name_1 admin 
OK 


redis 127.0.0.1:6379> SET user_level_1 9999 
OK 


# jack 


redis 127.0.0.1:6379> LPUSH uid 2 
(integer) 2 


redis 127.0.0.1:6379> SET user_name_2 jack 
OK 


redis 127.0.0.1:6379> SET user_level_2 10 
OK 


# peter 


redis 127.0.0.1:6379> LPUSH uid 3 
(integer) 3 


redis 127.0.0.1:6379> SET user_name_3 peter 
OK 


redis 127.0.0.1:6379> SET user_level_3 25 
OK 


# mary 


redis 127.0.0.1:6379> LPUSH uid 4 
(integer) 4 


redis 127.0.0.1:6379> SET user_name_4 mary 
OK 


redis 127.0.0.1:6379> SET user_level_4 70 
OK 


BY 选项 
默认 情况 下 ， sort uid 直接 按 uid 中 的 值 排序 : 


redis 127.0.0.1:6379> SORT uid 


admin‏ # ل (ك4 
jack‏ # 02 )2 
peter‏ # 137 ((3 
mary‏ # "4" )4 


通过 使 用 BY 选项 ， 可 以 让 uid 按 其 他 键 的 元 素来 排序 。 
比如 说 ， 以 下 代码 让 uid 键 按照 user_level {uid} 的 大 小 来 排序 : 


redis 127.0.0.1:6379> SORT uid BY user_level_* 


jack , level = 10‏ # 2 رلك 
peter, level = 25‏ # 13 )2 
mary, level = 70‏ # “4 (3 
admin, level = 9999‏ # ل AD‏ 


user_level_* 是 一 个 占 位 符 ， 它 先 取 出 uid 中 的 值 ， 然后 再 用 这 个 值 来 查找 相应 的 键 。 


比如 在 对 uid 列表 进行 排序 时 ， 程序 就 会 先 取 出 uid WH 1. 2. 3. 4, AA 
使 用 user_level_1 、 user level 2 、 user_level 3 和 user_level 4 的 值 作为 排序 uid 
的 权重 。 


GET 选项 
使 用 cet 选项， 可 以 根据 排序 的 结果 来 取出 相应 的 键 值 。 
比如 说 ， 以 下 代码 先 排序 uid , 再 取出 键 user_name_{uid} 的 值 : 


redis 127.0.0.1:6379> SORT uid GET user_name_* 


1) "admin" 
2) "jack" 
3) "peter" 
4) "mary" 


组 合 使 用 BY 和 GET 


通过 组 合 使 用 By 和 cet , 可 以 让 排序 结果 以 更 直观 的 方式 显示 出 来 。 


比如 说 ， 以 下 代码 先 按 user_level_{uid} 来 排序 uid JUR, 再 取出 相应 的 
user_name_{uid} 的 值 : 


redis 127.0.0.1:6379> SORT uid BY user_level_* GET user_name_* 


1) "jack" # level = 10 
2) "peter" # level = 25 
3) "mary" # level = 70 
4) "admin" # level = 9999 


现在 的 排序 结果 要 比 只 使 用 soRT uid BY user_level * 要 直观 得 多 。 


获取 多 个 外 部 键 
可 以 同时 使 用 多 个 cer 选项 ， 获取 多 个 外 部 键 的 值 。 


以 下 代码 就 按 uid 分 别 获 取 user_level_{uid} 和 user_name_{uid} 


redis 127.0.0.1:6379> SORT uid GET user_level_* GET user_name_* 


1) "9999" # level 
2) "admin" # name 
3) "46" 

4) "jack" 

5) "95" 

6) "peter" 

7) "70" 

8) "mary" 


GET 有 一 个 额外 的 参数 规则 ， 那 就 是 可 以 用 # 获取 被 排序 键 的 值 。 





以 下 代码 就 将 uid 的 值 、 及 其 相应 的 user_level_* 和 user_name_* 都 返回 为 结果 : 


redis 127.0.0.1:6379> SORT uid GET # GET user_level_* GET user_name_* 


WILY # uid‏ رلك 
level‏ # "9999" )2 
"admin" # name‏ )3 
Meu‏ )4 

5) "46" 

6) "jack" 

7) Pike x) 

8) "25" 

9) "peter" 

10) wast 

11) "70" 

12) "mary" 


获取 外 部 键 ， 但 不 进行 排序 


通过 将 一 个 不 存在 的 键 作为 参数 传 给 BY 选项 ， 可 以 让 sort 跳 过 排序 操作 ， 直接 返回 结 
果 


redis 127.0.0.1:6379> SORT uid BY not-exists-key 


1) wan 
2) ngu 
3) wou 
4) Wan 


这 种 用 法 在 单独 使 用 时 ， 没 什么 实际 用 处 。 


不 过 ， 通 过 将 这 种 用 法 和 cet 选项 配合 ， 就 可 以 在 不 排序 的 情况 下 ， 获取 多 个 外 部 键 ， 相 
当 于 执行 一 个 整合 的 获取 操作 (类 似 于 SQL 数据 库 的 join 关键 字 ) 。 


以 下 代码 演示 了 ， 如 何在 不 引起 排序 的 情况 下 ， 使 用 sort 、 BY 和 cet 获取 多 个 外 部 
键 : 


redis 127.0.0.1:6379> SORT uid BY not-exists-key GET # GET user_level_* GET user_name_* 
a1) "4" # id 


2) "70" # level 
3) "mary" # name 
4) mon 

5) "95" 

6) "peter" 

7) TAS 

8) "46" 

9) "jack" 

10) eA 

11) "9999" 

12) "admin" 


‘| 


将 哈 希 表 作为 GET 或 BY 的 参数 


除了 可 以 将 字符 串 键 之 外 ， 哈 希 表 也 可 以 作为 ET 或 BY 选项 的 参数 来 使 用 。 





比如 说 ， 对 于 前 面 给 出 的 用 户 信息 表 : 


uid username{uid} userlevel{uid} 
1 admin 9999 
2 jack 10 
3 peter 25 
4 mary 70 


我 们 可 以 不 将 用 户 的 名 字 和 级 别 保存 在 user name {uid} 和 user_level_{uid} 两 个 字符 串 键 
中 ， 而 是 用 一 个 带 有 name 域 和 level 域 的 哈 希 表 user_info_{uid} 来 保存 用 户 的 名 字 和 
级 别 信息 : 


redis 127.0.0.1:6379> HMSET user_info_1 name admin level 9999 
OK 


redis 127.0.0.1:6379> HMSET user_info_2 name jack level 10 
OK 


redis 127.0.0.1:6379> HMSET user_info_3 name peter level 25 
OK 


redis 127.0.0.1:6379> HMSET user_info_4 name mary level 70 
OK 


之 后 ， BY 和 cet 选项 都 可 以 用 key-agt;fiela 的 格式 来 获取 哈 希 表 中 的 域 的 值 ， 其 中 
key 表示 哈 希 表 键 ， 而 field 则 表示 哈 希 表 的 域 : 


redis 127.0.0.1:6379> SORT uid BY user_info_*->level 


1) Taun 

2) any 

3) nan 

4) ar Ka 

redis 127.0.0.1:6379> SORT uid BY user_info_*->level GET user_info_*->name 
1) "jack" 

2) "peter" 

3) "mary" 

4) "admin" 


保存 排序 结果 


默认 情况 下 ， SORT 操作 只 是 简单 地 返回 排序 结果 ， 并 不 进行 任何 保存 操作 。 
通过 给 STORE 选项 指定 一 个 key 参数 ， 可 以 将 排序 结果 保存 到 给 定 的 键 上 。 


如 果 被 指定 的 key 已 存在 ， 那 么 原 有 的 值 将 被 排序 结果 覆盖 。 


# 测试 数据 


redis 127.0.0.1:6379> RPUSH numbers 1 3 5 7 9 
(integer) 5 


redis 127.0.0.1:6379> RPUSH numbers 2 4 6 8 10 
(integer) 10 


redis 127.0.0.1:6379> LRANGE numbers 0 -1 


1) "q" 
2) ngu 
3) nou 
4) "7" 
5) nou 
6) won 
7) wan 
8) neu 
9) "g" 
10) "10" 


redis 127.0.0.1:6379> SORT numbers STORE sorted-numbers 
(integer) 10 


# 排序 后 的 结果 


redis 127.0.0.1:6379> LRANGE sorted-numbers © -1 


1) Wan 
2) wou 
3) ngu 
4) wan 
5) mB" 
6) "g" 
7) "7" 
8) ngu 
9) nou 
10) "10" 


可 以 通过 将 SORT 命令 的 执行 结果 保存 ， 并 用 EXPIRE 为 结果 设置 生存 时 间 ， 以 此 来 产生 一 
个 SORT 操作 的 结果 缓存 。 


这 样 就 可 以 避免 对 SORT 操作 的 频繁 调用 : 只 有 当 结 果 集 过 期 时 ， 才 需要 再 调用 一 次 SORT 
操作 。 


另外 ， 为 了 正确 实现 这 一 用 法 ， 你 可 能 需要 加 锁 以 避免 多 个 客户 端 同时 进行 缓存 重建 (也 就 是 
多 个 客户 端 ， 同 一 时 间 进 行 SORT 操作 ， 并 保存 为 结果 集 )， 具 体 参 见 SETNX HF. 


可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 


O(N+M*log(M)), n 为 要 排序 的 列表 或 集合 内 的 元 素数 量 ， Mm 为 要 返回 的 元 素数 量 。 如 果 
只 是 使 用 SORT 命令 的 ET 选项 获取 数据 而 没有 进行 排序 ， 时 间 复 条 度 O(N)。 


返回 值 : 


没有 使 用 store 参数 ， 返 回 列表 形式 的 排序 结果 。 使 用 store 参数 ， 返 回 排序 结果 的 元 素 
数量 。 


TTL 


TTL key 

以 秒 为 单位 ， 返 回 给 定 key 的 剩余 生存 时 间 (TTL, time to live), 
可 用 版 本 : 

>= 1.0.0 

at SRE: 

O(1) 

返回 值 : 


ke 不 存在 时 ， 返 回 -2 。 当 ky 存在 但 没有 设置 剩余 生存 时 间 时 ， 返 回 -1 . 5‏ فك 
则 ， 以 秒 为 单位 ， 返 回 key 的 剩余 生存 时 间 。‏ 


Note 


在 Redis 2.8 以 前 ， 当 key RH, NA ky 没有 设置 剩余 生存 时 间 时 ， 命 令 都 返回 -1 


o 


# 不 存在 的 key 


redis> FLUSHDB 
OK 


redis> TTL key 
(integer) -2 


# key 存在 ， 但 没有 设置 剩余 生存 时 间 


redis> SET key value 
OK 


redis> TTL key 
(integer) -1 


# 有 剩余 生存 时 间 的 key 


redis> EXPIRE key 10086 
(integer) 1 


redis> TTL key 
(integer) 10084 


TYPE 


TYPE key 

返回 key 所 储存 的 值 的 类 型 。 
可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 


none (key 不 存在 ) string (字符 串 ) list (列表 ) set (集合 ) zset (有 序 集 ) hash ( 


# 字符 串 


redis> SET weather "sunny" 
OK 


redis> TYPE weather 
string 


# 列表 


redis> LPUSH book_list "programming in scala" 
(integer) 1 


redis> TYPE book_list 
list 


# 集合 


redis> SADD pat "dog" 
(integer) 1 


redis> TYPE pat 
set 


哈 


希 


K) 


SCAN 


SCAN cursor [MATCH pattern] [COUNT count] 


SCAN 命令 及 其 相关 的 SSCAN RA, HSCAN ARA ZSCAN 命令 都 用 于 增 量 地 迭代 
(incrementally iterate) 一 集 元 素 (a collection of elements) 


٠ SCAN 命 合用 于 迭代 当前 数据 库 中 的 数据 库 键 。 

٠ SSCAN 命令 用 于 迭代 集合 键 中 的 元 素 。 

٠ HSCAN 命令 用 于 迭代 哈 希 键 中 的 键 值 对 。 

٠ ZSCAN 命令 用 于 迭代 有 序 集合 中 的 元 素 (包括 元 素 成 员 和 元 素 分 值 ) 。 


以 上 列 出 的 四 个 命令 都 支持 增 量 式 迭 代 ， 它们 每 次 执行 都 只 会 返回 少量 元 素 ， 所 以 这 些 命令 
可 以 用 于 生产 环境 ， 而 不 会 出 现 像 KEYS HE. SMEMBERS 命令 带 来 的 问题 当 
KEYS 命令 被 用 于 义理 一 个 大 的 数据 库 时 ， 又 或 者 SMEMBERS 命 命 被 用 于 人 处理 一 个 大 的 集 
合 键 时 ， 它们 可 能 会 阻塞 服务 器 达 数 秒 之 久 。 





不 过 ， 境 量 式 迭 代 命 令 也 不 是 没有 缺点 的 : 举 个 例子 ， 使 用 SMEMBERS 命令 可 以 返回 集 
合 键 当前 包含 的 所 有 元 素 ， 但 是 对 于 SCAN 这 类 增 量 式 和 迭代 命令 来 说 ， 因为 在 对 键 进行 增 量 
AERAR, 键 可 能 会 被 修改 ， 所 以 增 量 式 和 迭代 命令 只 能 对 被 返回 的 元 素 提 供 有 限 的 保 
证 (offer limited guarantees about the returned elements) 。 


SCAN, SSCAN, HSCAN 和 ZSCAN 四 个 命令 的 工作 方式 都 非常 相似 ， 所 以 这 个 文‏ زا 
档 会 一 并 介绍 这 四 个 命令 ， 但 是 要 记 住 :‏ 


e SSCAN 843, HSCAN MAA ZSCAN 命令 的 第 一 个 参数 总 是 一 个 数据 库 键 。 
٠ 而 SCAN 命 命 则 不 需要 在 第 一 个 参数 提供 任何 数据 库 键 一 一 因为 它 迭 代 的 是 当前 数据 库 
中 的 所 有 数据 库 键 。 


SCAN 命 全 的 基本 用 法 


SCAN 命令 是 一 个 基于 游标 的 迭代 器 (cursor based iterator) : SCAN 命令 每 次 被 调用 之 
后 ， 都 会 向 用 户 返回 一 个 新 的 游标 ， 用 户 在 下 次 迭代 时 需要 使 用 这 个 新 游标 作为 SCAN BD 
的 游标 参数 ， 以 此 来 延续 之 前 的 迭代 过 程 。 


4 SCAN 命令 的 游标 参数 被 设置 为 o nt, 服务 器 将 开始 一 次 新 的 迭代 ， 而 当 服务 器 向 用 户 
返回 值 为 o 的 游标 时 ， 表示 迭代 已 结束 。 


以 下 是 一 个 SCAN 命令 的 迭代 过 程 示例 : 


redis 127.0.0.1:6379> scan 0 
ay) Waly 
2) 1) "key:12" 
2) "key:8" 
3) "key:4" 
4) "key:14" 
5) "key:16" 
6) "key:17" 
7) "key:15" 
8) "key:10" 
9) "key:3" 
10) "key:7" 
11) "key:1" 
redis ae. 0.0.1:6379> scan 17 


2) 1) "key:5" 
2) "key:18" 
3) "key:0" 
4) "key:2" 
5) "key:19" 
6) "key:13" 
7) "key:6" 
8) "key:9" 
9) "key:11" 


在 上 面 这 个 例子 中 ， 第 一 次 迭代 使 用 @。 作为 游标 ， 表示 开始 一 次 新 的 迭代 。 
第 二 次 迭代 使 用 的 是 第 一 次 近代 时 返回 的 游标 ， 也 即 是 命令 回复 第 一 个 元 素 的 值 —— 17 。 


从 上 面 的 示例 可 以 看 到 ， SCAN 命令 的 回复 是 一 个 包含 两 个 元 素 的 数组 ， 第 一 个 数组 元 素 是 
用 于 进行 下 一 次 迭代 的 新 游标 ， 而 第 二 个 数组 元 素 则 是 一 个 数组 ， 这 个 数组 中 包含 了 所 有 被 
迭代 的 元 素 。 


在 第 二 次 调用 SCAN 命令 时 ， 命令 返回 了 游标 90 ， 这 表示 和 迭代 已 经 结束 ， 整个 数据 集 
(collection) 22 م‎ 历 过 了 。 


以 o 作为 游标 开始 一 次 新 的 迭代 ， 一 直 调 用 SCAN RD, 直到 命令 返回 游标 6 ， 我 们 


称 这 个 过 程 为 一 次 完整 青 历 (full iteration) 。 


SCAN 命令 的 保证 (guarantees) 


SCAN 命令 ， 以 及 其 他 增 量 式 迭 代 命 售 ， 在 进行 完整 各 历 的 情况 下 可 以 为 用 户 带 来 以 下 保 

证 : 从 完整 静 历 开始 直到 完整 通 历 结束 期 间 ， 一 直 存 在 于 数据 集 内 的 所 有 元 素 都 会 被 完整 通 

历 返 回 ; 这 意味 着 ， 如 果 有 一 个 元 素 ， 它 从 静 万 开始 直到 逼 历 结束 期 间 都 存在 于 被 静 历 的 数 

据 集 当 中 ， 那么 SCAN 命 命 总 会 在 某 次 迭代 中 将 这 个 元 素 返 回 给 用 户 。 

然而 因为 增 量 式 命 舍 仅 仅 使 用 游标 来 记录 和 碗 代 状 态 。 所 以 这 些 命令 带 有 以 下 缺点 : 

。 同一 个 元 素 可 能 会 被 返回 多 次 。 处理 重 复元 素 的 工作 交 由 应 用 程序 负责 ， 比如 说 ， 可 以 
考虑 将 迭代 返回 的 元 素 仅 仅 用 于 可 以 安全 地 重复 执行 多 次 的 操作 上 。 


。 如 果 一 个 元 素 是 在 迭代 过 程 中 被 添加 到 数据 集 的 ， 又 或 者 是 在 迭代 过 程 中 从 数据 集中 被 
删除 的 ， 那么 这 个 元 素 可 能 会 被 返回 ， 也 可 能 不 会 ， 这 是 未 定义 的 (undefined) 。 


SCAN 命令 每 次 执行 返回 的 元 素 效 量 
增 量 式 迁 代 命令 并 不 保证 每 次 执行 都 返回 某 个 给 定数 量 的 元 素 。 


增 量 式 命令 甚至 可 能 会 返回 需 个 元 素 ， 但 只 要 命令 返回 的 游标 不 是 © , 应 用 程序 就 不 应 该 
将 迭代 视 作 结束 。 


不 过 命令 返回 的 元 素数 量 总 是 符合 一 定 规则 的 ， 在 实际 中 : 


。 对 于 一 个 大 数据 集 来 说 ， 增 量 式 迭 代 命 命 每 次 最 多 可 能 会 返回 数 十 个 元 素 ; 

。 而 对 于 一 个 足够 小 的 数据 集 来 说 ， 如 果 这 个 数据 集 的 底层 表示 为 编码 数据 结构 
(encoded data structure， 适 用 于 是 小 集合 键 、 小 哈 希 键 和 小 有 序 集合 键 ) ， 那么 增 量 
迭代 命令 将 在 一 次 调用 中 返回 数据 集中 的 所 有 元 素 。 


最 后 ， 用 户 可 以 通过 增 量 式 迭 代 命 合 提 供 的 cout 选项 来 指定 每 次 迭代 返回 元 素 的 最 大 
值 。 


COUNT 选项 


虽然 增 量 式 迭 代 命 合 不 保证 每 次 迭代 所 返回 的 元 素数 量 ， 但 我 们 可 以 使 用 count 选项 ， 对 
命 命 的 行为 进行 一 定 程度 上 的 调整 。 


HALT, cout 选项 的 作用 就 是 让 用 户 告知 迭代 命令 ， 在 每 次 迭代 中 应 该 从 数据 集 里 返回 


多 少 元 素 。 


虽然 cont 选项 只 是 对 增 量 式 迭 代 命 合 的 一 种 提示 (hint), 但 是 在 大 多 数 情况 下 ， 这 种 提 
示 都 是 有 效 的 。 


e count 参数 的 默认 值 为 10 o 

。 在 迭代 一 个 足够 大 的 、 由 哈 希 表 实 现 的 数据 库 、 集 合 键 、 哈 希 键 或 者 有 序 集合 键 时 ， 如 
果 用 户 没有 使 用 MATcH 选项 ， 那么 命令 返回 的 元 素数 量 通常 和 cout 选项 指定 的 一 
样 ， 或 者 比 couNT 选项 指定 的 数量 稍 多 一 些 。 

。 在 迭代 一 个 编码 为 整数 集合 (intset， 一 个 只 由 整数 值 构成 的 小 集合 ) 、 或 者 编码 为 压缩 
列表 (ziplist， 由 不 同 值 构成 的 一 个 小 哈 希 或 者 一 个 小 有 序 集合 ) 时 ， 增 量 式 迭 代 命 令 通 
常会 无 视 couNT 选项 指定 的 值 ， 在 第 一 次 迭代 就 将 数据 集 包含 的 所 有 元 素 都 返回 给 用 
户 。 

Note 
并 非 每 次 迭代 都 要 使 用 相同 的 count 值 。 


用 户 可 以 在 每 次 迭代 中 按 自己 的 需要 随意 改变 cout 值 ， 只 要 记得 将 上 次 迭代 返回 的 游标 
用 到 下 次 迭代 里 面 就 可 以 了 。 


MATCH 选项 


ja KEYS 命令 一 样 ， 增 量 式 迭 代 命令 也 可 以 通过 提供 一 个 glob 风格 的 模式 参数 ， 让 命 


返回 和 给 定 模 式 相 匹配 的 元 素 ， 这 一 点 可 以 通过 在 执行 增 量 式 迭 代 命 令 时 ， 通过 给 定 
MATCH &lt;patternagt; 参数 来 实现 。 


以 下 是 一 个 使 用 march 选项 进行 迭代 的 示例 : 


redis 127.0.0.1:6379> sadd myset 1 2 3 foo foobar feelsgood 
(integer) 6 


redis 127.0.0.1:6379> sscan myset 0 match f* 


1) mgu 

2) 1) "foo" 
2) "feelsgood" 
3) "foobar" 


注意 的 是 ， 对 元 素 的 模式 匹配 工作 是 在 命令 从 数据 集中 取出 元 素 之 后 ， 向 客户 端 返 回 


回 元 


表 之 前 的 这 段 时 间 内 进行 的 所 以 如 果 被 迭代 的 数据 集中 只 有 少量 元 素 和 模式 相 匹 配 ， 那么 


迭代 命令 或 许 会 在 多 次 执行 中 都 不 返回 任何 元 素 。 
以 下 是 这 种 情况 的 一 个 例子 


redis 127.0.0.1:6379> scan © MATCH *11* 
1) Wore ven 
2) 1) "key:911" 


redis 127.0.0.1:6379> scan 288 MATCH *11* 
Al) 0224 
2) (empty list or set) 


redis 127.0.0.1:6379> scan 224 MATCH *11* 
1) "30o" 

2) (empty list or set) 

redis 127.0.0.1:6379> scan 80 MATCH *11* 
1) "476" 

2) (empty list or set) 


redis 127.0.0.1:6379> scan 176 MATCH *11* COUNT 1000 


1) now 

2) 1) "key:611" 
2) "key:711" 
3) "key:118" 
4) "key:117" 
5) "key:311" 
6) "key:112" 
7) "key:111" 
8) "key:110" 
9) "key:113" 


10) "key:211" 
11) "key:411" 
12) "key:115" 
13) "key:116" 
14) "key:114" 
15) "key:119" 
16) "key:811" 
17) "key:511" 
18) "key:11" 


如 你 所 见 ， 以 上 的 大 部 分 迭代 都 不 返回 任何 元 素 。 


在 最 后 一 次 迭代 ， 我 们 通过 将 couNT 选项 的 参数 设置 为 1000 ， 强制 命 合 为 本 次 迭代 扫描 
更 多 元 素 ， 从 而 使 得 命令 返回 的 元 素 也 变 多 了 。 


FER ANTS MAN 


在 同一 时 间 ， 可 以 有 任意 多 个 客户 端 对 同一 数据 集 进行 迭代 ， 客户 端 每 次 执行 迭代 都 需要 传 
入 一 个 游标 ， 并 在 迭代 执行 之 后 获得 一 个 新 的 游标 ， 而 这 个 游标 就 包含 了 迭代 的 所 有 状态 ， 
因此 ， 服务 器 无 须 为 迭代 记录 任何 状态 。 


中 途 俘 止 迭代 

因为 迭代 的 所 有 状态 都 保存 在 游标 里 面 ， 而 服务 器 无 须 为 迭代 保存 任何 状态 。 所 以 客户 端 可 
以 在 中 途 停止 一 个 迭代 ， 而 无 须 对 服务 器 进行 任何 通知 。 

即使 有 任意 数量 的 迭代 在 中 途 停止 ， 也 不 会 产生 任何 问题 。 


使 用 错误 的 游标 进行 增 量 式 迭 代 

使 用 间断 的 〔broken) 、 负 数 、 超 出 范围 或 者 其 他 非 正常 的 游标 来 执行 增 量 式 迁 代 并 不 会 千 
AUR FRAN, 但 可 能 会 让 命令 产生 未 定义 的 行为 。 

未 定义 行为 指 的 是 ， 增 量 式 命令 对 返回 什 所 做 的 保证 可 能 会 不 再 为 真 。 

只 有 两 种 游标 是 合法 的 : 


1. 在 开始 一 个 新 的 迭代 时 ， 游标 必须 为 9 。 
2. 增 量 式 迭 代 命 合 在 执行 之 后 返回 的 ， 用 于 延续 (continue) 迭代 过 程 的 游标 。 


迭代 终结 的 保证 


增 量 式 和 迭代 命 合 所 使 用 的 算法 只 保证 在 数据 集 的 大 小 有 界 (bounded) 的 情况 下 ， ERFA 
停止 ， 换 句 话说 ， 如果 被 迭代 数据 集 的 大 小 不 断 地 增长 的 话 ， 增 量 式 迭代 命 合 可 能 永远 也 无 
法 完成 一 次 完整 迭代 。 


从 直觉 上 可 以 看 出 ， 当 一 个 数据 集 不 断 地 变 大 时 ， 想 要 访问 这 个 数据 集中 的 所 有 元 素 就 需要 
做 越 来 越 多 的 工作 ， 能 否 结束 一 个 迭代 取决 于 用 户 执行 迭代 的 速度 是 否 比 数据 集 增长 的 速度 
更 快 。 


可 用 版 本 : 


> >= 2.8.0 
at SRE: 


> 增 量 式 迭代 命 命 每 次 执行 的 复杂 度 为 O(1) ， 对 数据 集 进 行 一 次 完整 迭代 的 复杂 度 为 O(N) 
， 其 中 N 为 数据 集中 的 元 素数 量 。 


返回 值 : 


> SCAN #843, SSCAN #843, HSCAN 命令 和 ZSCAN 命令 都 返回 一 个 包含 两 个 元 素 的 
multi-bulk 回复 : 回复 的 第 一 个 元 素 是 字符 串 表 示 的 无 符号 64 位 整数 (游标 ) , 回复 的 第 二 
个 元 素 是 另 一 个 multi-bulk 回复 ， 这 个 multi-bulk 回复 包含 了 本 次 被 迭代 的 元 素 。 > > SCAN 
命令 返回 的 每 个 元 素 都 是 一 个 数据 库 键 。 > > SSCAN 命令 返回 的 每 个 元 素 都 是 一 个 集合 成 
Ro > > HSCAN 命令 返回 的 每 个 元 素 都 是 一 个 键 值 对 ， 一 个 键 值 对 由 一 个 键 和 一 个 值 组 成 。 
> > ZSCAN 命令 返回 的 每 个 元 素 都 是 一 个 有 序 集 合 元 素 ， 一 个 有 序 集 合 元 素 由 一 个 成 员 
(member) 和 一 个 分 值 (score) 组 成 。 


String (FFE) 


APPEND 


APPEND key value 


如 果 key 已 经 存在 并 且 是 一 个 字符 串 ， APPEND 命令 将 value 追加 到 key 原来 的 值 的 
末尾 。 
如 果 key 不 存在 ， APPEND 就 简单 地 将 给 定 key 设 为 value ， 就 像 执 行 
SET key value 一 样 。 
可 用 版 本 : 
>= 2.0.0 
at SAE : 
平 挫 O(1) 
返回 值 : 
追加 value Zia, ke 中 字符 串 的 长 度 。 
# 对 不 存在 的 key 执行 APPEND 
redis> EXISTS myphone # 确保 myphone 不 存在 
(integer) 0 
redis> APPEND myphone "nokia" # 对 不 存在 的 key 进行 APPEND ， 等 同 于 SET myphone "nokia' 


(integer) 5 # FHKE 
# 对 已 存在 的 字符 串 进 行 APPEND 


redis> APPEND myphone " - 1110" # KEM 5 个 字符 增加 到 12 个 字符 
(integer) 12 


redis> GET myphone 
"nokia - 1110" 


二 "| 


模式 : 时 间 序 列 (Time series) 


APPEND 可 以 为 一 系列 定 长 (fixed-size 数 据 (sample) 提 供 一 种 紧凑 的 表示 方式 ， 


时 间 序 列 。 


每 当 一 个 新 数据 到 达 的 时 候 ， 执 行 以 下 命令 : 


APPEND timeseries "fixed-size sample" 


然后 可 以 通过 以 下 的 方式 访问 时 间 序 列 的 各 项 属性 : 


通常 称 之 为 


٠ STRLEN 给 出 时 间 序列 中 数据 的 数量 

。 GETRANGE 可 以 用 于 随机 访问 。 只 要 有 相关 的 时 间 信 息 的 话 ， 我 们 就 可 以 在 Redis 6 
中 使 用 Lua 脚本 和 GETRANGE 命令 实现 二 分 查找 。 

٠ SETRANGE 可 以 用 于 覆盖 或 修改 已 存在 的 的 时 间 序 列 。 


这 个 模式 的 唯一 缺陷 是 我 们 只 能 增长 时 间 序 列 ， 而 不 能 对 时 间 序 列 进行 缩短 ， 因 为 Redis A 
前 还 没有 对 字符 串 进 行 修剪 (tirm) 的 命 舍 ， 但 是 ， 不 管 怎 么 说 ， 这 个 模式 的 储存 方式 还 是 可 以 
节省 下 大 量 的 空间 。 


Note 


可 以 考虑 使 用 UNIX 时 间 戳 作为 时 间 序 列 的 键 名 ， 这 样 一 来 ， 可 以 避免 单个 key 因为 保存 过 
大 的 时 间 序 列 而 占用 大 量 内 存 ， 另 一 方面 ， 也 可 以 节省 下 大 量 命名 空间 。 


下 面 是 一 个 时 间 序 列 的 例子 : 
redis> APPEND ts "0043" 
(integer) 4 


redis> APPEND ts "0035" 
(integer) 8 


redis> GETRANGE ts 0 3 
"0043" 


redis> GETRANGE ts 4 7 
"9035" 


BITCOUNT 


BITCOUNT key [start] [end] 

计算 给 定 字符 串 中 ， 被 设置 为 1 的 比特 位 的 数量 。 

一 般 情况 下 ， 给 定 的 整个 字符 串 都 会 被 进行 计数 ， 通 过 指定 额外 的 start 或 end 参数 ， 可 
以 让 计数 只 在 特定 的 位 上 进行 。 

start 和 end 参数 的 设置 和 GETRANGE 命令 类 似 ， 都 可 以 使 用 负数 值 : 比如 -1 表示 
最 后 一 个 字 节 ， -2 表示 倒数 第 二 个 字 节 ， 以 此 类 推 。 


不 存在 的 key 被 当成 是 空 字符 串 来 处 理 ， 因 此 对 一 个 不 存在 的 key 进行 BITcouNT 操作 ， 
结果 为 9 。 


可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(N) 

返回 值 : 

被 设置 为 1 的 位 的 数量 。 


redis> BITCOUNT bits 
(integer) 0 


redis> SETBIT bits © 1 # 0001 
(integer) 0 


redis> BITCOUNT bits 
(integer) 1 


redis> SETBIT bits 3 1 # 1001 
(integer) 0 


redis> BITCOUNT bits 
(integer) 2 


模式 : 使 用 bitmap 实现 用 户 上 线 次 数 统计 
Bitmap 对 于 一 些 特定 关 型 的 计算 非常 有 效 。 


假设 现在 我 们 希望 记录 自己 网 站 上 的 用 户 的 上 线 频 率 ， 比 如 说 ， 计 算 用 户 A 上线 了 多 少 天 ， 
用 户 B 上 线 了 多 少 天 ， 诸 如 此 类 ， 以 此 作为 数据 ， 从 而 决定 让 哪些 用 户 参 加 beta 测试 等 活动 
一 一 这 个 模式 可 以 使 用 SETBIT #0 BITCOUNT 来 实现 。 


比如 说 ， 每 当 用 户 在 某 一 天 上 线 的 时 候 ， 我 们 就 使 用 512171817 ， 以 用 户 名 作为 key ， 将 那天 
所 代表 的 网 站 的 上 线 日 作为 offset 参数 ， 并 将 这 个 offset 上 的 为 设置 为 1 ه‎ 

举 个 例子 ， 如 果 今 天 是 网 站 上 线 的 第 100 K, MAP peter 在 今天 阅览 过 网 站 ， 那 么 执行 命 
43 SETBIT peter 1001 ; 如 果 明 天 peter 也 继续 阅览 网 站 ， 那 么 执行 命令 

SETBIT peter 101 1 ， 以 此 类 推 。 

当 要 计算 peter 总 共 以 来 的 上 线 次 数 时 ， 就 使 用 BITCOUNT 命令 : 执行 BITCOUNT peter , 
得 出 的 结果 就 是 peter 上 线 的 总 天 数 。 


更 详细 的 实现 可 以 参考 博文 ( 墙 外 ) Fast, easy, realtime metrics using Redis bitmaps 。 


性 能 


前 面 的 上 线 次 数 统计 例子 ， 即 使 运行 10 年 ， 占 用 的 空间 也 只 是 每 个 用 户 10*365 比特 位 
(bity)， 也 即 是 每 个 用 户 456 字 节 。 对 于 这 种 大 小 的 数据 来 说 ， BITCOUNT 的 义理 速度 就 像 
GET 和 /NCR 这 种 O(1) 复杂 度 的 操作 一 样 快 。 


如 果 你 的 bitmap 数据 非常 大 ， 那 么 可 以 考虑 使 用 以 下 两 种 方法 : 


1. 将 一 个 大 的 bitmap 分 散 到 不 同 的 key 中 ， 作 为 小 的 bitmap 来 处 理 。 使 用 Lua 脚本 可 以 
很 方便 地 完成 这 一 工作 。 

2. 使 用 BITCOUNT 的 start 和 end 参数 ， 每 次 只 对 所 需 的 部 分 位 进行 计算 ， 将 位 的 累 
积 工作 (accumulating) 放 到 客户 端 进行 ， 并 且 对 结果 进行 缓存 (caching)。 


BITOP 


BITOP operation destkey key [key ...] 
对 一 个 或 多 个 保存 二 进 制 位 的 字符 串 key 进行 位 元 操作 ， 并 将 结果 保存 到 destkey 上 。 
operation 可 以 是 AND . oR 、 NoT 、 xoR 这 四 种 操作 中 的 任意 一 种 : 


© BITOP AND destkey key [key ...[ ， 对 一 个 或 多 个 key 求 逻 辑 并 ， 并 将 结果 保存 到 


destkey 。 

eBITOP OR destkey key [key ...[ ， 对 一 个 或 多 个 key 求 逮 辑 或 ， 并 将 结果 保存 到 
destkey 。 

e BITOP XOR destkey key [key ...] ， 对 一 个 或 多 个 key 求 逻辑 异 或 ， 并 将 结果 保存 到 
destkey 。 


© BITOP NOT destkey key ， 对 给 定 key 求 逻 辑 非 ， 并 将 结果 保存 到 destkey o 
除了 not 操作 之 外 ， 其 他 操作 都 可 以 接受 一 个 或 多 个 key 作为 输入 。 
处 理 不 同 长 度 的 字符 串 
4 BITOP 处 理 不 同 长 度 的 字符 串 时 ， 较 短 的 那个 字符 串 所 缺少 的 部 分 会 被 看 作 8@ 。 
ZA key 也 被 看 作 是 包含 o 的 字符 串 序列 。 
可 用 版 本 : 
>= 2.6.0 
时 间 复 杂 度 : 
O(N) 
返回 值 : 
保存 到 destkey 的 字符 串 的 长 度 ， 和 输入 key 中 最 长 的 字符 串 长 度 相 等 。 
Note 


BITOP 的 复杂 度 为 O(N) ， 当 处 理 大 型 矩阵 (matrix) 或 者 进行 大 数据 量 的 统计 时 ， 最 好 将 任务 
指派 到 附属 节点 (slave) 进 行 ， 避 人 免 阻塞 主 节点 。 


redis> SETBIT bits-1 © 1 
(integer) 0 


redis> SETBIT bits-1 3 1 
(integer) 0 


redis> SETBIT bits-2 0 1 
(integer) 0 


redis> SETBIT bits-2 1 1 
(integer) 0 


redis> SETBIT bits-2 3 1 
(integer) 0 


# bits-1 = 1001 


# bits-2 = 1011 


redis> BITOP AND and-result bits-1 bits-2 


(integer) 1 


redis> GETBIT and-result 0 
(integer) 1 


redis> GETBIT and-result 1 
(integer) 0 


redis> GETBIT and-result 2 
(integer) 0 


redis> GETBIT and-result 3 
(integer) 1 


# and-result 


1001 


DECR 


DECR key 

将 key 中 储存 的 数字 值 减 一 。 

如 果 key PEE, MA key 的 值 会 先 被 初始 化 为 。， 然 后 再 执行 DECR 操作 。 
如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限 制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

关于 递增 (increment) / 递减 (decrement) 操 作 的 更 多 信息 ， 请 参见 INCR PB. 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 


执行 DECR 命令 之 后 key 的 值 。 


# 对 存在 的 数字 值 key 进行 DECR 


redis> SET failure_times 10 
OK 


redis> DECR failure_times 
(integer) 9 


# 对 不 存在 的 key 值 进 行 DECR 


redis> EXISTS count 
(integer) 0 


redis> DECR count 
(integer) -1 


# 对 存在 但 不 是 数值 的 key 进行 DECR 


redis> SET company YOUR_CODE_SUCKS.LLC 
OK 


redis> DECR company 
(error) ERR value is not an integer or out of range 


DECRBY 


DECRBY key decrement 

将 key 所 储存 的 值 减 去 减 量 decrement o 

如 果 key 不 存在 ， 那 么 key 的 值 会 先 被 初始 化 为 o ， 然 后 再 执行 DECRBY 操作 。 
如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

关于 更 多 递增 (increment) / 递减 (decrement) 操 作 的 更 多 信息 ， 请 参见 INCR BR. 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

减 去 decrement 之 后 ， key 的 值 。 


# 对 已 存在 的 key 进行 DECRBY 


redis> SET count 100 
OK 


redis> DECRBY count 20 
(integer) 80 


# 对 不 存在 的 key 进行 DECRBY 


redis> EXISTS pages 
(integer) 0 


redis> DECRBY pages 10 
(integer) -10 


GET 


GET key 

返回 key 所 关联 的 字符 串 值 。 

如 果 key 不 存在 那么 返回 特殊 值 nil 。 

假如 key 储存 的 值 不 是 字符 串 类 型 ， 返 回 一 个 错误 ， 因 为 GET 只 能 用 于 处 理 字符 串 值 。 
可 用 版 本 : 

>= 1.0.0 


at SRE: 


当 key PFE, REl nil , Am, BE key 的 值 。 如 果 key 不 是 字符 串 类 型 ， 那 么 
返回 一 个 错误 。 


# 对 不 存在 的 key 或 字符 串 类 型 key 进行 GET 


redis> GET db 
(nil) 


redis> SET db redis 
OK 


redis> GET db 
"redis" 


# 对 不 是 字符 串 类 型 的 key 进行 GET 


redis> DEL db 
(integer) 1 


redis> LPUSH db redis mongodb mysql 
(integer) 3 


redis> GET db 
(error) ERR Operation against a key holding the wrong kind of value 


GETBIT 


GETBIT key offset 

对 key 所 储存 的 字符 串 值 ， 获 取 指 定 偏 移 量 上 的 位 (bit)。 

4 offset LFA BARKER, RG key 不 存在 时 ， 返 回 o 。 
可 用 版 本 : 

>= 2.2.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

字符 串 值 指定 偏 移 量 上 的 位 (bit)。 


# 对 不 存在 的 key 或 者 不 存在 的 offset 进行 GETBIT， 返回 0 


redis> EXISTS bit 
(integer) 0 


redis> GETBIT bit 10086 
(integer) 0 


# 对 已 存在 的 offset 进行 GETBIT 


redis> SETBIT bit 10086 1 
(integer) 0 


redis> GETBIT bit 10086 
(integer) 1 


GETRANGE 


GETRANGE key start end 


返回 key 中 字符 串 值 的 子 字符 串 ， 字 符 串 的 截取 范围 由 start 和 end 两 个 偏 移 量 决定 ( 包 
15 start 和 end 在 内 )。 


负数 偏 移 量 表示 从 字符 串 最 后 开始 计数 ， -1 表示 最 后 一 个 字符 ， -2 表示 倒数 第 二 个 ， 以 
此 类 推 。 


GETRANGE 通过 保证 子 字 符 串 的 值 域 (range) 不 超过 实际 字符 串 的 值 域 来 处 理 超出 范围 的 值 
域 请 求 。 


Note 

在 <= 2.0 的 版 本 里 ，GETRANGE 被 叫 作 SUBSTR。 
可 用 版 本 : 

>= 2.4.0 

时 间 复 条 度 : 


O(N), n 为 要 返回 的 字符 串 的 长 度 。 复 条 度 最 终 由 字符 串 的 返回 值 长 度 决 定 ， 但 因为 从 已 
有 字符 串 中 取出 子 字符 串 的 操作 非常 廉价 (cheap)， 所 以 对 于 长 度 不 大 的 字符 串 ， 该 操作 的 复 
杂 度 也 可 看 作 O(1)。 


返回 值 : 
截取 得 出 的 子 字 符 串 。 


redis> SET greeting "hello, my friend" 


OK 
redis> GETRANGE greeting 0 4 # 返回 索引 0-4 的 字符 ， 包 括 4。 
"hello" 

redis> GETRANGE greeting -1 -5 # 不 支持 回 绕 操 作 

redis> GETRANGE greeting -3 -1 # 负数 索引 

"end" 

redis> GETRANGE greeting © -1 # 从 第 一 个 到 最 后 一 个 


"hello, my friend" 


redis> GETRANGE greeting 0 1008611 # 值 域 范 围 不 超过 实际 字符 串 ， 超 过 部 分 自动 被 符 略 
"hello, my friend" 


GETSET 


GETSET key value 

将 给 定 key 的 值 设 为 value ， 并 返回 key 的 旧 值 (old value). 
当 key 存在 但 不 是 字符 串 类 型 时 ， 返 回 一 个 错误 。 

可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 


O(1) 
返回 值 : 
返回 给 定 key 的 旧 值 。 当 key 没有 旧 值 时 ， 也 即 是 ， key 不 存在 时 ， 返 回 nil 。 


redis> GETSET db mongodb # 没有 旧 值 ， 返 回 nil 
(nil) 


redis> GET db 
"mongodb" 


redis> GETSET db redis # 返回 旧 值 mongodb 
"mongodb" 


redis> GET db 
"redis" 


模式 
GETSET 可 以 和 INCR 组 合 使 用 ， 实 现 一 个 有 原子 性 (atomic) 复 位 操作 的 计数 器 (counter)。 


举例 来 说 ， 每 次 当 某 个 事件 发 生 时 ， 进 程 可 能 对 一 个 名 为 mycount 的 key 调用 /NCR 操 
作 ， 通 常 我 们 还 要 在 一 个 原子 时 间 内 同时 完成 获得 计数 器 的 值 和 将 计数 器 值 复位 为 6 两 个 操 
作 。 


可 以 用 命令 GETSET mycounter 0 来 实现 这 一 目标 。 


redis> INCR mycount 
(integer) 11 


redis> GETSET mycount 0 # 一 个 原子 内 完成 GET mycount 和 SET mycount 0 操作 
Wer ا‎ Fi 


redis> GET mycount # 计数 器 被 重 置 
Ng" 
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INCR 


INCR key 

将 key 中 储存 的 数字 值 增 一 。 

如 果 key PEE, MA key 的 值 会 先 被 初始 化 为 o ， 然 后 再 执行 INCR 操作 。 
如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

Note 


这 是 一 个 针对 字符 串 的 操作 ， 因 为 Redis 没有 专用 的 整数 类 型 ， 所 以 key 内 储存 的 字符 串 被 
解释 为 十 进 制 64 位 有 符号 整数 来 执行 INCR 操作 。 


可 用 版 本 : 
>= 1.0.0 

时 间 复 杂 度 : 
O(1) 
返回 值 : 


执行 INCR 命令 之 后 key 的 值 。 
redis> SET page_view 0 
OK 


redis> INCR page_view 
(integer) 21 


redis> GET page_view # 数字 值 在 Redis 中 以 字符 串 的 形式 保存 
ss 


<+ ` 5 5 a 口 
模式 : 计数 器 
计数 器 是 Redis 的 原子 性 自 增 操作 可 实现 的 最 直观 的 模式 了 ， 它 的 想法 相当 简单 : 每 当 某 个 
操作 发 生 时 ， 向 Redis 发 送 一 个 INCR ASe 


比如 在 一 个 web 应 用 程序 中 ， 如 果 想 知道 用 户 在 一 年 中 每 天 的 点 击 量 ， 那 么 只 要 将 用 户 ID 
以 及 相关 的 日 期 信息 作为 键 ， 并 在 每 次 用 户 点 击 页 面 时 ， 执 行 一 次 自 增 操作 即 可 。 


比如 用 户 名 是 peter ， 点 击 时间 是 2012 年 3 月 22 日 ， 那 么 执行 命令 


INCR peter : :2012.3.22 o 


可 以 用 以 下 几 种 方式 扩展 这 个 简单 的 模式 : 


٠ 可 以 通过 组 合 使 用 INCR 和 EXPIRE ， 来 达到 只 在 规定 的 生存 时 间 内 进行 计数 (counting) 
的 目的 。 

。 客户 端 可 以 通过 使 用 GETSET 命令 原子 性 地 获取 计数 器 的 当前 值 并 将 计数 器 清 需 ， 更 多 
信息 请 参考 GETSET 命 合 。 

٠ 使 用 其 他 自 增 / 自 减 操 作 ， 比 如 DECR 和 INCRBY ， 用 户 可 以 通 
或 减少 计数 器 的 值 ， 比 如 在 游戏 中 的 记分 器 就 可 能 用 到 这 些 命令 


过 执行 不 同 的 操作 增加 
模式 : 限 速 器 


限 速 器 是 特殊 化 的 计算 器 ， 它 用 于 限制 一 个 操作 可 以 被 执行 的 速率 (rate)。 


限 速 器 的 典型 用 法 是 限制 公开 API 的 请 求 次 数 ， 以 下 是 一 个 限 速 器 实现 示例 ， 它 将 API 的 最 
大 请 求 数 限 制 在 每 个 IP 地 址 每 秒 钟 十 个 之 内 : 


FUNCTION LIMIT_API_CALL(ip) 
ts = CURRENT_UNIX_TIME() 
keyname = ip+":"+ts 

current = GET(keyname) 


IF current != NULL AND current > 10 THEN 
ERROR "too many requests per second" 
END 


IF current == NULL THEN 
MULTI 
INCR(keyname, 1) 
EXPIRE(keyname, 1) 
EXEC 
ELSE 
INCR(keyname, 1) 
END 


PERFORM_API_CALL() 
这 个 实现 每 秒 钟 为 每 个 IP 地 址 使 用 一 个 不 同 的 计数 器 ， 并 用 EXPIRE 命令 设置 生存 时 间 ( 这 
样 Redis 就 会 负责 自动 删除 过 期 的 计数 器 )。 


注意 ， 我 们 使 用 事务 打包 执行 NCR 命令 和 EXPIRE 命令 ， 避 免 引 入 竞争 条 件 ， 保 证 每 次 调 
用 API 时 都 可 以 正确 地 对 计数 器 进行 自 增 操作 并 设置 生存 时 间 。 


以 下 是 另 一 个 限 速 器 实现 : 


FUNCTION LIMIT_API_CALL(ip): 
current = GET(ip) 
IF current != NULL AND current > 10 THEN 
ERROR "too many requests per second" 
ELSE 
value = INCR(ip) 
IF value == 1 THEN 
EXPIRE(ip, 1) 
END 
PERFORM_API_CALL() 
END 


这 个 限 速 器 只 使 用 单个 计数 器 ， 它 的 生存 时 间 为 一 秒 钟 ， 如 果 在 一 秒 钟 内 ， 这 个 计数 器 的 值 
大 于 10 的话， 那么 访问 就 会 被 禁止 。 


这 个 新 的 限 速 器 在 思路 方面 是 没有 问题 的 ， 但 它 在 实现 方面 不 够 严谨 ， 如 果 我 们 仔细 观察 一 
下 的 话 ， 就 会 发 现在 INCR 和 EXPIRE 之 间 存 在 着 一 个 竞争 条 件 ， 假 如 客户 端 在 执行 /INCR 
之 后 ， 因 为 某 些 原因 (比如 客户 站 aM EAE ies hee 个 计数 器 就 会 一 直 存 


在 下 去 ， 造成 每 个 用 户 只 能 访问 10 次 ， 噢 ， 这 i f E 站 是 个 灾难 |! 


要 消灭 这 个 实现 中 的 竞争 条 件 ， 我 们 可 以 将 它 转化 为 一 个 Lua A, FMB Redis 中 运行 (这 
个 方法 仅 限 于 Redis 2.6 及 以 上 的 版 本 ) : 


local current 

current = redis.call("incr",KEYS[1]) 

if tonumber(current) == 1 then 
redis.call("expire",KEYS[1],1) 

end 


通过 将 计数 器 作为 脚本 放 到 Redis 上 运行 ， 我 们 保证 了 INCR 和 EXPIRE 两 个 操作 的 原子 
性 ， 现 在 这 个 脚本 实现 不 会 引入 竞争 条 件 ， 它 可 以 运作 的 很 好 。 


关于 在 Redis 中 运行 Lua 脚本 的 更 多 信息 ， 请 参考 EVAL PA, 


还 有 另 一 种 消灭 竞争 条 件 的 方法 ， 就 是 使 用 Redis 的 列表 结构 来 代替 NCR 命令 ， 这 个 方法 
无 须 脚本 支持 ， 因 此 它 在 Redis 2.6 以 下 的 版 本 也 可 以 运行 得 很 好 : 


FUNCTION LIMIT_API_CALL(ip) 
current = LLEN(ip) 
IF current > 10 THEN 
ERROR "too many requests per second" 
ELSE 
IF EXISTS(ip) == FALSE 
MULTI 
RPUSH(ip, ip) 
EXPIRE(ip,1) 
EXEC 
ELSE 
RPUSHX(ip, ip) 
END 
PERFORM_API_CALL() 
END 


新 的 限 速 器 使 用 了 列表 结构 作为 容器 ， LLEN 用 于 对 访问 次 数 进行 检查 ， 一 个 事务 包 应 着 
RPUSH 和 EXPIRE 两 个 命 舍 ， 用 于 在 第 一 次 执行 计数 时 创建 列表 ， 并 正确 设置 地 设置 过 期 
时 间 ， 最 后 ， RPUSHX 在 后 续 的 计数 操作 中 进行 增加 操作 。 


INCRBY 


INCRBY key increment 

将 key 所 储存 的 值 加 上 增 量 increment o 

如 果 key 不 存在 ， 那 么 key 的 值 会 先 被 初始 化 为 o ， 然 后 再 执行 INCRBY MD. 
如 果 值 包含 错误 的 类 型 ， 或 字符 串 类 型 的 值 不 能 表示 为 数字 ， 那 么 返回 一 个 错误 。 
本 操作 的 值 限制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

关于 递增 (increment) / 递减 (decrement) 操 作 的 更 多 信息 ， 参 见 INCR AR. 

可 用 版 本 : 

>= 1.0.0 

at SRE: 

O(1) 

返回 值 : 


加 上 increment 之 后 ， key 的 值 。 


# key 存在 且 是 数字 值 


redis> SET rank 50 
OK 


redis> INCRBY rank 20 
(integer) 70 


redis> GET rank 
mW 70 W 


# key 不 存在 时 


redis> EXISTS counter 
(integer) 0 


redis> INCRBY counter 30 
(integer) 30 


redis> GET counter 
mW 30 W 


# key 不 是 数字 值 时 


redis> SET book "long long ago..." 
OK 


redis> INCRBY book 200 
(error) ERR value is not an integer or out of range 


INCRBYFLOAT 


INCRBYFLOAT key increment 
A key 中 所 储存 的 值 加 上 浮 点 数 增 量 increment o 
如 果 key 不 存在 ， 那 么 INCRBYFLOAT BIE key 的 值 设 为 9 ， 再 执行 加 法 操作 。 


如 果 命 令 执 行 成 功 ， 那 么 key 的 值 会 被 更 新 为 《执行 加 法 之 后 的 ) 新 值 ， 并 且 新 值 会 以 字符 
串 的 形式 返回 给 调用 者 。 


无 论 是 key 的 值 ， 还 是 增 量 increment ， 都 可 以 使 用 像 2.0e7 、 3e5 、 96e-2 那样 的 
指数 符号 (exponential notation) 来 表示 ， 但 是 ， 执 行 INCRBYFLOAT 命令 之 后 的 值 总 是 以 同 
样 的 形式 储存 ， 也 即 是 ， 它 们 总 是 由 一 个 数字 ， 一 个 (可 选 的 ) 小 数 点 和 一 个 任意 位 的 小 数 
部 分 组 成 (比如 3.14 . 69.768 ， 诸 如 此 类 )， 小 数 部 分 尾随 的 o 会 被 移 除 ， 如 果 有 需要 
的 话 ， 还 会 将 浮 点 数 改 为 整数 (比如 3.0 会 被 保存 成 3 ) 。 


除 此 之 外 ， 无 论 加 法 计算 所 得 的 浮 点 数 的 实际 精度 有 多 长 ， INCRBYFLOAT 的 计算 结果 也 最 
多 只 能 表示 小 数 点 的 后 十 七 位 。 


当 以 下 任意 一 个 条 件 发 生 时 ， 返 回 一 个 错误 : 


» ky 的 值 不 是 字符 串 类 型 (因为 Redis 中 的 数字 和 浮 点 数 都 以 字符 串 的 形式 保存 ， 所 以 
它们 都 属于 字符 串 类 型 ) 

e key 当前 的 值 或 者 给 定 的 增 量 increment 不 能 解释 (parse) 为 双 精 度 浮 点 数 (double 
precision floating point number) 


可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

执行 命令 之 后 key 的 值 。 


# 值 和 增 量 都 不 是 指数 符号 


redis> SET mykey 10.50 
OK 


redis> INCRBYFLOAT mykey 0.1 
"709.6" 


# 值 和 增 量 都 是 指数 符号 


redis> SET mykey 314e-2 


OK 

redis> GET mykey # 用 SET 设置 的 值 可 以 是 指数 符号 

"3146-2" 

redis> INCRBYFLOAT mykey 9 # 但 执行 INCRBYFLOAT 之 后 格式 会 被 改 成 非 指数 符号 
ا عل‎ 


# 可 以 对 整数 类 型 执行 


redis> SET mykey 3 
OK 


redis> INCRBYFLOAT mykey 1.1 
اا‎ 


# 后 跟 的 9 会 被 移 除 


redis> SET mykey 3.0 
OK 


redis> GET mykey # SET 设置 的 值 小 数 部 分 可 以 是 0 
"32,60" 


redis> INCRBYFLOAT mykey 1.000000000000000000000 # # 但 INCRBYFLOAT 会 将 无 用 的 9 忽略 掉 ， 有 和 
Wane 


redis> GET mykey 
Wat 
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MGET 


MGET key [key ...] 
返回 所 有 (一 个 或 多 个 ) 给 定 key 的 值 。 


如 果 给 定 的 key 里 面 ， 有 某 个 key 不 存在 ， 那 么 这 个 key 返回 特殊 值 nil 。 因 此 ， 该 
命令 永 不 失败 。 


可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 


O(N), ١ 为 给 定 key 的 数量 。 


一 个 包含 所 有 给 定 key 的 值 的 列表 。 


redis> SET redis redis.com 
OK 


redis> SET mongodb mongodb.org 
OK 


redis> MGET redis mongodb 
1) "redis.com" 
2) "mongodb.org" 


redis> MGET redis mongodb mysql # 不 存在 的 mysql 返回 nil 
1) "redis.com" 

2) "mongodb.org" 

3) (nil) 


MSET 


MSET key value [key value ...] 
同时 设置 一 个 或 多 个 key-value 对 。 


如 果 某 个 给 定 ky BAFE, MA MSET 会 用 新 值 履 盖 原 来 的 旧 值 ， 如 果 这 不 是 你 所 希望 
的 效果 ， 请 考虑 使 用 MSETNX 命令 : 它 只 会 在 所 有 给 定 key 都 不 存在 的 情况 下 进行 设置 操 
作 。 


MSET 是 一 个 原子 性 (atomic) 操 作 ， 所 有 给 定 key 都 会 在 同一 时 间 内 被 设置 ， 某 些 给 定 
key 被 更 新 而 另 一 些 给 定 key 没有 改变 的 情况 ， 不 可 能 发 生 。 


可 用 版 本 : 

>= 1.0.1 

时 间 复 条 度 : 

O(N), N 为 要 设置 的 key 数量 。 


返回 


应 


总 是 返回 ok (因为 mser 不 可 能 失败 ) 


redis> MSET date "2012.3.30" time "11:00 a.m." weather "sunny" 
OK 


redis> MGET date time weather 
1) "2012.3.30" 

2) "11:00 a.m." 

3) "sunny" 


# MSET 682818 ع1‎ 


redis> SET google "google.hk" 
OK 


redis> MSET google "google.com" 
OK 


redis> GET google 
"google.com" 


MSETNX 


MSETNX key value [key value ...] 
同时 设置 一 个 或 多 个 key-value 对 ， 当 且 仅 当 所 有 给 定 key 都 不 存在 。 
即使 只 有 一 个 给 定 key 已 存在 ， MSETNX 也 会 拒绝 执行 所 有 给 定 key 的 设置 操作 。 


MSETNX 是 原子 性 的 ， 因 此 它 可 以 用 作 设 置 多 个 不 同 key 表示 不 同 字段 (field) 的 唯一 性 逻辑 
对 象 (unique logic object)， 所 有 字段 要 么 全 被 设置 ， 要 么 全 不 被 设置 。 


可 用 版 本 : 

>= 1.0.1 

时 间 复 条 度 : 

O(N), n 为 要 设置 的 key 的 数量 。 
返回 值 : 


当 所 有 key 都 成 功 设置 ， 返 回 1 。 如 果 所 有 给 定 key 都 设置 失败 (至 少 有 一 个 key 已 经 
FE) MARE o 。 


# 对 不 存在 的 key 进行 MSETNX 


redis> MSETNX rmdbs "MySQL" nosql "MongoDB" key-value-store "redis" 
(integer) 1 


redis> MGET rmdbs nosql key-value-store 


1) "MySQL" 
2) "MongoDB" 
3) "redis" 


# MSET 的 给 定 key 当中 有 已 存在 的 key 


redis> MSETNX rmdbs "Sqlite" language "python" # rmdbs 键 已 经 存在 ， 操 作 失 败 
(integer) 0 


redis> EXISTS language # 因为 MSET 是 原子 性 操作 ，language 没有 被 设置 
(integer) 0 

redis> GET rmdbs # rmdbs 也 没有 被 修改 

"MySQL" 


2) 


PSETEX 


PSETEX key milliseconds value 


这 个 命令 和 SETEX 命 命 相 似 ， 但 它 以 毫秒 为 单位 设置 key 的 生存 时 间 ， 而 不 是 像 SETEX 
命令 那样 ， 以 秒 为 单位 。 


可 用 版 本 : 


设置 成 功 时 返回 ok 。 
redis> PSETEX mykey 1000 "Hello" 
OK 


redis> PTTL mykey 
(integer) 999 


redis> GET mykey 
"Hello" 


SET 


SET key value [EX seconds] [PX milliseconds] [NX|XX] 
将 字符 串 值 value 关联 到 key o 
如 果 key 已 经 持 有 其 他 值 ， SET MESHE, TAXE, 


对 于 某 个 原本 带 有 生存 时 间 (TTL) 的 键 来 说 ， 当 SET 命令 成 功 在 这 个 键 上 执行 时 ， 这 个 键 
RAR TTL 将 被 清除 。 


可 选 参数 
M Redis 2.6.12 版 本 开始 ， SET 命令 的 行为 可 以 通过 一 系列 参数 来 修改 : 
e EX second : 设置 键 的 过 期 时 间 为 second 秒 。 SET key value EX second 效果 等 同 于 


SETEX key second value o 

e PX millisecond : 设置 键 的 过 期 时 间 为 millisecond BF), 
SET key value PX millisecond 效果 等 同 于 PSETEX key millisecond value o 

e NX : 只 在 键 不 存在 时 ， 才 对 键 进行 设置 操作 。 sET key value NX 效果 等 同 于 
SETNX key value ه‎ 


٠ xx : 只 在 键 已 经 存在 时 ， 才 对 键 进行 设置 操作 。 
Note 


因为 SET 命令 可 以 通过 参数 来 实现 和 SETNX、 SETEX 和 PSETEX 三 个 命令 的 效果 ， 所 以 
将 来 的 Redis 版 本 可 能 会 废弃 并 最 终 移 除 SETNX、 SETEX 和 PSETEX 这 三 个 命令 。 


可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 


O(1) 


在 Redis 2.6.12 版 本 以 前 ， SET 命令 总 是 返回 ok 。 


M Redis 2.6.12 版 本 开始 ， SET 在 设置 操作 成 功 完成 时 ， 才 返回 ok 。 如 果 设 置 了 Nx 或 
者 xx ， 但 因为 条 件 没 达 到 而 造成 设置 操作 未 执行 ， 那 么 命令 返回 空 批量 回复 (NULL Bulk 
Reply) 。 


# 对 不 存在 的 键 进行 设置 


redis 127.0.0.1:6379> SET key "value" 


OK 


redis 127.0.0.1:6379> GET key 
"value" 


# 对 已 存在 的 键 进行 设置 


redis 127.0.0.1:6379> SET key "new-value" 
OK 


redis 127.0.0.1:6379> GET key 
"new-value" 


# 使 用 EX 选项 


redis 127.0.0.1:6379> SET key-with-expire-time "hello" EX 10086 
OK 


redis 127.0.0.1:6379> GET key-with-expire-time 
"hello" 


redis 127.0.0.1:6379> TTL key-with-expire-time 
(integer) 10069 


# 使 用 PX 选项 


redis 127.0.0.1:6379> SET key-with-pexpire-time "moto" PX 123321 
OK 


redis 127.0.0.1:6379> GET key-with-pexpire-time 
"moto" 


redis 127.0.0.1:6379> PTTL key-with-pexpire-time 
(integer) 111939 


# 使 用 NX 选项 


redis 127.0.0.1:6379> SET not-exists-key "value" NX 
OK # 键 不 存在 ， 设 置 成 功 


redis 127.0.0.1:6379> GET not-exists-key 
"value" 


redis 127.0.0.1:6379> SET not-exists-key "new-value" NX 
(nil) # 键 已 经 存在 ， 设 置 失败 


redis 127.0.0.1:6379> GEt not-exists-key 
"value" # 维持 原 值 不 变 


# 使 用 XX 选项 


redis 127.0.0.1:6379> EXISTS exists-key 
(integer) 0 


redis 127.0.0.1:6379> SET exists-key "value" XX 
(nil) # 因为 键 不 存在 ， 设 置 失败 


redis 127.0.0.1:6379> SET exists-key "value" 
OK # 先 给 键 设置 一 个 值 


redis 127.0.0.1:6379> SET exists-key "new-value" XX 
OK # 设置 新 值 成 功 


redis 127.0.0.1:6379> GET exists-key 
"new-value" 


# NX 或 XX 可 以 和 EX 或 者 PX 组 合 使 用 


redis 127.0.0.1:6379> SET key-with-expire-and-NX "hello" EX 10086 NX 
OK 


redis 127.0.0.1:6379> GET key-with-expire-and-NxX 


"hello" 


redis 127.0.0.1:6379> TTL key-with-expire-and-Nx 
(integer) 10063 


redis 127.0.0.1:6379> SET key-with-pexpire-and-XxX "old value" 
OK 


redis 127.0.0.1:6379> SET key-with-pexpire-and-XxX "new value" PX 123321 
OK 


redis 127.0.0.1:6379> GET key-with-pexpire-and-Xx 
"new value" 


redis 127.0.0.1:6379> PTTL key-with-pexpire-and-Xx 
(integer) 112999 


# EX 和 PX 可 以 同时 出 现 ， 但 后 面 给 出 的 选项 会 覆盖 前 面 给 出 的 选项 


redis 127.0.0.1:6379> SET key "value" EX 1000 PX 5000000 
OK 


redis 127.0.0.1:6379> TTL key 
(integer) 4993 # 这 是 PX 参数 设置 的 值 


redis 127.0.0.1:6379> SET another-key "value" PX 5000000 EX 1000 
OK 


redis 127.0.0.1:6379> TTL another -key 
(integer) 997 # 这 是 EX 参数 设置 的 值 


使 用 模式 


命令 SET resource-name anystring NX EX max-lock-time 是 一 种 在 Redis 中 实现 锁 的 简单 方 


Ho 
客户 端 执 行 以 上 的 命 兮 


٠ 如 果 服 务 器 返回 ok ， 那 么 这 个 客户 端 获 得 锁 。 
٠ 如 果 服 务 器 返回 NIL ， 那 么 客户 端 获取 锁 失 败 ， 可 以 在 稍 后 再 重 试 。 


设置 的 过 期 时 间 到 达 之 后 ， 锁 将 自动 释放 。 
可 以 通过 以 下 修改 ， 让 这 个 锁 实现 更 健壮 : 


。 不 使 用 固定 的 字符 串 作为 键 的 值 ， 而 是 设置 一 个 不 可 猜测 (non-guessable) 的 长 随机 字 
符 串 ， 作 为 口令 串 (token) 。 

。 不 使 用 DEL 命令 来 释放 锁 ， 而 是 发 送 一 个 Lua 脚本 ， 这 个 脚本 只 在 客户 端 传人 的 值 和 键 
的 口令 串 相 匹配 时 ， 才 对 键 进行 删除 。 


这 两 个 改动 可 以 防止 持 有 过 期 锁 的 客户 端 误 删 现 有 锁 的 情况 出 现 。 
以 下 是 一 个 简单 的 解锁 脚本 示例 : 


if redis.call("get",KEYS[1]) == ARGV[1] 
then 

return redis.call("del",KEYS[1]) 
else 

return 0 
end 


这 个 脚本 可 以 通过 EVAL ...script... 1 resource-name token-value 命令 来 调用 。 


SETBIT 


SETBIT key offset value 

对 key 所 储存 的 字符 串 值 ， 设 置 或 清除 指定 偏 移 量 上 的 位 (bit)。 
位 的 设置 或 清除 取决 于 valu 参数 ， 可 以 是 6 也 可 以 是 1 。 
كك‎ ky 不 存在 时 ， 自 动 生成 一 个 新 的 字符 串 值 。 


字符 串 会 进行 伸展 (grown) 以 确保 它 可 以 将 value 保存 在 指定 的 偏 移 量 上 。 当 字符 串 值 进行 
伸展 时 ， 空 白 位 置 以 。 填充 。 


offset 参数 必须 大 于 或 等 于 o , WF 2^32 (bit 映射 被 限制 在 512 MB 之 内 )。 
Warning 


对 使 用 大 的 offset 的 SETBIT 操作 来 说 ， 内 存 分 配 可 能 造成 Redis 服务 器 被 阻塞 。 具 体 参 
者 SETRANGE 命令 ，warning( 警 告 ) 部 分 。 


可 用 版 本 : 

>= 2.2.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

指定 偏 移 量 原来 储存 的 位 。 


redis> SETBIT bit 10086 1 
(integer) 0 


redis> GETBIT bit 10086 
(integer) 1 


redis> GETBIT bit 100 # bit 默认 被 初始 化 为 0 
(integer) 0 


SETEX 


SETEX key seconds value 


将 值 value 关联 到 key ， 并 将 key 的 生存 时 间 设 为 seconds (以 秒 为 单位 )。 


如 果 key 已 经 存在 ， SETEX 命令 将 履 写 旧 值 。 


这 个 命令 类 似 于 以 下 两 个 命令 : 


SET key value 
EXPIRE key seconds # 设置 生存 时 间 


不 同 之 处 是 ， SETEX 是 一 个 原子 性 (atomic) 操 作 ， 关 联 值 和 设置 
时 间 内 完成 ， 该 命令 在 Redis 用 作 缓 存 时 ， 非 常 实 用 。 


可 用 版 本 : 
>= 2.0.0 

时 间 复杂 度 : 
(1) 
返回 值 : 


O 


置 生存 时 间 两 个 动作 会 在 同一 


设置 成 功 时 返回 ok 。 当 seconds 参数 不 合法 时 ， 返 回 一 个 错误 。 


# 在 key 不 存在 时 进行 SETEX 


redis> SETEX cache_user_id 60 10086 
OK 


redis> GET cache_user_id # خش‎ 
"10086" 


redis> TTL cache_user_id # 剩余 生存 时 间 
(integer) 49 


# key 已 经 存在 时 ，SETEX BRIA 


redis> SET cd "timeless" 
OK 


redis> SETEX cd 3000 "goodbye my love" 
OK 


redis> GET cd 
"goodbye my love" 


redis> TTL cd 
(integer) 2997 


SETNX 


SETNX key value 

将 key 的 值 设 为 value ， 当 且 仅 当 key 不 存在 。 

若 给 定 的 key 已 经 存在 ， 则 SETNX 不 做 任何 动作 。 
SETNX Æ ISET if Not eXists] (如果 不 存在 ， 则 SET) 的 简写 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

(1) 

返回 值 : 


O 


设置 成 功 ， 返 回 1 。 设 置 失败 ， 返 回 © ه‎ 


< 


redis> EXISTS job # job 不 存在 
(integer) 0 


redis> SETNX job "programmer" # job 设置 成 功 
(integer) 1 


redis> SETNX job "code-farmer" # 尝试 覆盖 job , Km 
(integer) 0 


redis> GET job # 没有 被 覆盖 
"programmer" 


SETRANGE 


SETRANGE key offset value 
FA value BBB FS (overwrite) key PT eA eB 5 , 从 偏 移 量 offset 开始 。 
不 存在 的 key 当 作 空白 字符 串 处 理 。 


SETRANGE 命令 会 确保 字符 串 足 够 长 以 便 将 value 设置 在 指定 的 偏 移 量 上 ， 如 果 给 定 
key 原来 储存 的 字符 串 长 度 比 偏 移 量 小 (比如 字符 串 只 有 5 个 字符 长 ， 但 你 设置 的 offset 
是 10 )， 那 么 原 字 符 和 偏 移 量 之 间 的 空白 将 用 需 字 节 (zerobytes，"\xee" ) 来 填充 。 


注意 你 能 使 用 的 最 大 偏 移 量 是 2^*29-1(536870911) ， 因 为 Redis 字符 串 的 大 小 被 限制 在 2 
兆 (megabytes) 以 内 。 如 果 你 需要 使 用 比 这 更 大 的 空间 ， 你 可 以 使 用 多 个 key 。 


Warning 


当 生 成 一 个 很 长 的 字符 串 时 ，Redis 需要 分 配 内 存 空间 ， 该 操作 有 时 候 可 能 会 造成 服务 器 阻塞 
(block)。 在 2010 年 的 Macbook Pro 上 ， 设 置 偏 移 量 为 536870911(512MB AFD), FRY 
300 毫秒 ， 设置 偏 移 量 为 134217728(128MB 内 存 分 配 )， 耗 费 约 80 毫秒 ， 设 置 偏 移 量 
33554432(32MB 内 存 分 配 )， 耗 费 约 30 毫秒 ， 设 置 偏 移 量 为 8388608(8MB AFAM), HA 
约 8 毫秒 。 注意 铝 首次 内 存 分 配 成 功 之 后 ， 再 对 同一 个 key 调用 SETRANGE 操作 ， 无 须 
再 重新 内 存 。 


可 用 版 本 : 
>= 2.2.0 
时 间 复 杂 度 : 


对 小 (small) 的 字符 串 ， 平 捧 复 条 度 O(1)。( 关 于 什么 字符 串 是 "小 "的 ， 请 参考 APPEND tH) 
否则 为 O(M)， M A value 参数 的 长 度 。 


返回 值 : 
被 SETRANGE 修改 之 后 ， 字 符 串 的 长 度 。 


# 对 非 空 字符 串 进行 SETRANGE 


redis> SET greeting "hello world" 
OK 


redis> SETRANGE greeting 6 "Redis" 
(integer) 11 


redis> GET greeting 
"hello Redis" 


# 对 空 字 符 串 /不 存在 的 key 进行 SETRANGE 


redis> EXISTS empty_string 
(integer) 0 


redis> SETRANGE empty_string 5 "Redis!"  # 对 不 存在 的 key 使 用 SETRANGE 
(integer) 11 


redis> GET empty_string # 空白 处 被 "\x99" 填 充 
"\xOO\xOO\xXOO\xXOO\xOORedis!" 


模式 


因为 有 了 SETRANGE 和 GETRANGE 命令 ， 你 可 以 将 Redis 字符 串 用 作 具 有 O(1) 随 机 访问 
时 间 的 线性 数组 ， 这 在 很 多 真实 用 例 中 都 是 非常 快速 且 高 效 的 储存 方式 ， 上 有 具体 请 参考 
APPEND 命令 的 『 模 式 : 时 间 序 列 」 部 分 。 


STRLEN 


STRLEN key 

返回 key 所 储存 的 字符 串 值 的 长 度 。 

key 储存 的 不 是 字符 串 值 时 ， 返 回 一 个 错误 。‏ كك 
可 用 版 本 :‏ 

>= 2.2.0 

SRE: 

O(1) 

返回 值 : 

字符 串 值 的 长 度 。 当 ky 不 存在 时 ， 返 回 o 。 


# 获取 字符 串 的 长 度 


redis> SET mykey "Hello world" 
OK 


redis> STRLEN mykey 
(integer) 11 


# 不 存在 的 key 长 度 为 0 


redis> STRLEN nonexisting 
(integer) 0 


Hash (FÄR) 


HDEL 


HDEL key field [field ...[ 
删除 哈 希 表 key 中 的 一 个 或 多 个 指定 域 ， 不 存在 的 域 将 被 忽略 。 
Note 


在 Redis2.4 以 下 的 版 本 里 ， HDEL 每 次 只 能 删除 单个 域 ， 如 果 你 需要 在 一 个 原子 时 间 内 删除 
多 个 域 ， 请 将 命令 包含 在 MULTI I EXEC 块 内 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(N), n 为 要 删除 的 域 的 数量 。 

返回 值 : 

被 成 功 移 除 的 域 的 数量 ， 不 包括 被 忽略 的 域 。 


# 测试 数据 
redis> HGETALL abbr 
1) Waitt 

2) "apple" 
3) يام أبن‎ 
4) "banana" 
5) TEN 

6) أن‎ - 1 
7) Welt 

8) "dog" 

# 删除 单个 域 


redis> HDEL abbr a 
(integer) 1 


# 删除 不 存在 的 域 


redis> HDEL abbr not-exists-field 
(integer) 0 


# 删除 多 个 域 


redis> HDEL abbr bc 
(integer) 2 


redis> HGETALL abbr 
1) Wea [YJ 
2) "dog" 


HEXISTS 


HEXISTS key field 

查看 哈 希 表 key 中 ， 给 定 域 field 是 否 存在 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复杂 度 : 

O(1) 

返回 值 : 

如 果 哈 希 表 含有 给 定 域 ， 返 回 1 。 如 果 哈 希 表 不 含有 给 定 域 , 或 key HE, Eo. 


redis> HEXISTS phone myphone 
(integer) 0 


redis> HSET phone myphone nokia-1110 
(integer) 1 


redis> HEXISTS phone myphone 
(integer) 1 


HGET 


HGET key field 

返回 哈 希 表 key 中 给 定 域 field 的 值 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(1) 


返回 值 : 


给 定 域 的 值 。 当 给 定 域 不 存在 或 是 给 定 key 不 存在 时 ， 返 回 nil o 


# 域 存在 


redis> HSET site redis redis.com 
(integer) 1 


redis> HGET site redis 
"redis.com" 


# 域 不 存在 


redis> HGET site mysql 
(nil) 


HGETALL 


HGETALL key 

返回 哈 希 表 key 中， 所 有 的 域 和 值 。 

在 返回 值 里 ， 紧 跟 每 个 域名 (field name) 之 后 是 域 的 值 (value)， 所 以 返回 值 的 长 度 是 哈 希 表 大 
小 的 两 倍 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(N), AN 为 哈 希 表 的 大 小 。 

返回 值 : 

以 列表 形式 返回 哈 希 表 的 域 和 域 的 值 。 若 key 不 存在 ， 返 回 空 列 表 。 


redis> HSET people jack "Jack Sparrow" 
(integer) 1 


redis> HSET people gump "Forrest Gump" 
(integer) 1 


redis> HGETALL people 
1) "jack" # 域 
2) "Jack Sparrow" # 值 
3) "gump" 

4) "Forrest Gump" 


HINCRBY 


HINCRBY key field increment 

为 哈 希 表 key 中 的 域 field 的 值 加 上 增 量 increment ه‎ 

增 量 也 可 以 为 负数 ， 相 当 于 对 给 定 域 进行 减法 操作 。 

如 果 key 不 存在 ， 一 个 新 的 哈 希 表 被 创建 并 执行 HINCRBY RR. 
如 果 域 field 不 存在 ， 那 么 在 执行 命令 前 ， 域 的 值 被 初始 化 为 。 。 
对 一 个 储存 字符 串 值 的 域 field 执行 HINCRBY 命令 将 造成 一 个 错误 。 
本 操作 的 值 被 限制 在 64 位 (bit) 有 符号 数字 表示 之 内 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 


执行 HINCRBY 命令 之 后 ， 哈 希 表 key 中 域 field 的 值 。 


# increment 为 正 数 


redis> HEXISTS counter page_view # 对 空域 进行 设置 
(integer) 0 


redis> HINCRBY counter page_view 200 
(integer) 200 


redis> HGET counter page_view 
"200" 


# increment 为 负数 


redis> HGET counter page_view 
"200" 


redis> HINCRBY counter page_view -50 
(integer) 150 


redis> HGET counter page_view 
"150" 


# 党 试 对 字符 串 值 的 域 执 行 HINCRBY 命 兮 


redis> HSET myhash string hello,world # 设 定 一 个 字符 串 值 
(integer) 1 


redis> HGET myhash string 
"hello, world" 


redis> HINCRBY myhash string 1 # 命令 执行 失败 ， 错 误 。 
(error) ERR hash value is not an integer 


redis> HGET myhash string # RATE 
"hello, world" 


HINCRBYFLOAT 


HINCRBYFLOAT key field increment 
ANBAR key 中 的 域 field 加 上 浮 点 数 增 量 increment o 


如 果 哈 希 表 中 没有 域 field ， 那 么 HINCRBYFLOAT 会 先 将 域 field 的 值 设 为 0 ， 然 后 
再 执行 加 法 操作 。 


如 果 键 key 不 存在 ， 那 么 HINCRBYFLOAT 会 先 创建 一 个 哈 希 表 ， 再 创建 域 field ， 最 后 
再 执行 加 法 操作 。 


当 以 下 任意 一 个 条 件 发 生 时 ， 返 回 一 个 错误 : 


e IÈ field 的 值 不 是 字符 串 类 型 (因为 redis 中 的 数字 和 浮 点 数 都 以 字符 串 的 形式 保存 ， 所 
以 它们 都 属于 字符 串 类 型 ) 

。 域 field 当前 的 值 或 给 定 的 增 量 increment 不 能 解释 (parse) 为 双 精 度 浮 点 数 (double 
precision floating point number) 


HINCRBYFLOAT 命令 的 详细 功能 和 INCRBYFLOAT 命令 类 似 ， 请 查看 INCRBYFLOAT AS 
获取 更 多 相关 信息 。 


可 用 版 本 : 

>= 2.6.0 

at SRE: 

O(1) 

返回 值 : 

执行 加 法 操作 之 后 field 域 的 值 。 


# 值 和 增 量 都 是 普通 小 数 


redis> HSET mykey field 10.50 
(integer) 1 

redis> HINCRBYFLOAT mykey field 0.1 
"10.6" 


# 值 和 增 量 都 是 指数 符号 


redis> HSET mykey field 5.0e3 
(integer) 0 

redis> HINCRBYFLOAT mykey field 2.0e2 
"5200" 


# 对 不 存在 的 键 执行 HINCRBYFLOAT 


redis> EXISTS price 

(integer) 0 

redis> HINCRBYFLOAT price milk 3.5 
key ay 

redis> HGETALL price 

1) "milk" 

2) ke Syl 


# 对 不 存在 的 域 进行 HINCRBYFLOAT 


redis> HGETALL price 

1) "milk" 

2) We 

redis> HINCRBYFLOAT price coffee 4.5 
WA 

redis> HGETALL price 


1) "milk" 
2) ITAN 
3) "coffee" 


4) "4.5" 


# 新 增 coffee 18 


HKEYS 


HKEYS key 

返回 哈 希 表 key 中 的 所 有 域 。 
可 用 版 本 : 

>= 2.0.0 


时 间 复 条 度 : 


一 个 包含 哈 希 表 中 所 有 域 的 表 。 当 ky 不 存在 时 ， 返 回 一 个 空 表 。 


# 哈 希 表 非 空 


redis> HMSET website google www.google.com yahoo www.yahoo.com 
OK 


redis> HKEYS website 
1) "google" 

2) "yahoo" 

# 空 哈 希 表 /key 不 存在 


redis> EXISTS fake_key 
(integer) 0 


redis> HKEYS fake_key 
(empty list or set) 


HLEN 


HLEN key 

返回 哈 希 表 key 中 域 的 数量 。 

时 间 复 条 度 : 

O(1) 

返回 值 : 

哈 希 表 中 域 的 数量 。 当 key 不 存在 时 ， 返 回 o 。 


redis> HSET db redis redis.com 
(integer) 1 


redis> HSET db mysql mysql.com 
(integer) 1 


redis> HLEN db 
(integer) 2 


redis> HSET db mongodb mongodb.org 
(integer) 1 


redis> HLEN db 
(integer) 3 


HMCET 


HMGET key field [field ...] 
返回 哈 希 表 key 中 ， 一 个 或 多 个 给 定 域 的 值 。 
如 果 给 定 的 域 不 存在 于 哈 希 表 ， 那 么 返回 一 个 nil 值 。 


因为 不 存在 的 key 被 当 作 一 个 空 哈 希 表 来 人 处理， 所 以 对 一 个 不 存在 的 key 进行 HMGET 操 
作 将 返回 一 个 只 带 有 nil 值 的 表 。 


可 用 版 本 : 
>= 2.0.0 


THERE: 


一 个 包含 多 个 给 定 域 的 关联 值 的 表 ， 表 值 的 排列 顺序 和 给 定 域 参数 的 请 求 顺 序 一 样 。 


redis> HMSET pet dog "doudou" cat "nounou" # 一 次 设置 多 个 域 

OK 

redis> HMGET pet dog cat fake_pet # 返回 值 的 顺序 和 传 入 参数 的 顺序 一 样 
1) "doudou" 


2) "nounou" 


3) (nil) # 不 存在 的 域 返回 nil 值 


HMSET 


HMSET key field value [field value ...] 
同时 将 多 个 field-value ( 域 - 值 ) 对 设置 到 哈 希 表 key 中 。 
此 命令 会 覆盖 哈 希 表 中 已 存在 的 域 。 
如 果 key 不 存在 ， 一 个 空 哈 希 表 被 创建 并 执行 HMSET 操作 。 
可 用 版 本 : 
>= 2.0.0 
时 间 复 杂 度 : 
O(N), N 为 field-value 对 的 数量 。 
返回 值 : 
如 果 命 合 执 行 成 功 ， 返 回 ok 。 当 key 不 是 哈 希 表 (hash) 类 型 时 ， 返 回 一 个 错误 。 


redis> HMSET website google www.google.com yahoo www.yahoo.com 
OK 


redis> HGET website google 
"www.google.com" 


redis> HGET website yahoo 
"www.yahoo.com" 


HSET 


HSET key field value 

将 哈 希 表 key 中 的 域 field 的 值 设 为 value o 

如 果 key 不 存在 ， 一 个 新 的 哈 希 表 被 创建 并 进行 HSET 操作 。 
如 果 域 field 已 经 存在 于 哈 希 表 中 ， 旧 值 将 被 覆盖 。 

可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 


如 果 field 是 哈 希 表 中 的 一 个 新 建 域 ， 并 且 值 设置 成 功 ， 返 回 1 。 如 果 哈 希 表 中 域 
field 已 经 存在 且 旧 值 已 被 新 值 覆 盖 ， 返 回 o 。 


redis> HSET website google "www.g.cn" # 设置 一 个 新 域 
(integer) 1 


redis> HSET website google "www.google.com" # 履 盖 一 个 旧 域 
(integer) 0 


HSETNX 


HSETNX key field value 

将 哈 希 表 key 中 的 域 field 的 值 设置 为 value ， 当 且 仅 当 域 fied 不 存在 。 
若 域 field 已 经 存在 ， 该 操作 无 效 。 

如 果 key 不 存在 ， 一 个 新 哈 希 表 被 创建 并 执行 HSETNX 命令 。 

可 用 版 本 : 

>= 2.0.0 


at SRE: 


设置 成 功 ， 返 回 1 。 如 果 给 定 域 已 经 存在 且 没有 操作 被 执行 ， 返 回 o 。 


redis> HSETNX 50501 key-value-store redis 
(integer) 1 


redis> HSETNX nosql key-value-store redis # 操作 无 效 ， 域 key-value-store 已 存在 
(integer) 0 


HVALS 


HVALS key 

返回 哈 希 表 key 中 所 有 域 的 值 。 
可 用 版 本 : 

>= 2.0.0 


时 间 复 条 度 : 


返回 值 : 
一 个 包含 哈 希 表 中 所 有 值 的 表 。 当 key 不 存在 时 ， 返 回 一 个 空 表 。 


# 非 空 哈 希 表 


redis> HMSET website google www.google.com yahoo www.yahoo.com 
OK 


redis> HVALS website 
1) "www.google.com" 
2) "www.yahoo.com" 


# 空 哈 希 表 /不 存在 的 key 


redis> EXISTS not_exists 
(integer) 0 


redis> HVALS not_exists 
(empty list or set) 


HSCAN 


HSCAN key cursor [MATCH pattern] [COUNT count] 


具体 信息 请 参考 SCAN 7. 


List (列表 ) 


BLPOP 


BLPOP key [key ...] timeout 
BLPOP 是 列表 的 阻塞 式 (blocking) 弹 出 原 语 。 


它 是 LPOP 命 合 的 阻塞 版 本 ， 当 给 定 列表 内 没有 任何 元 素 可 供 弹 出 的 时 人 息 ， 连 接 将 被 BLPOP 
命令 阻塞 ， 直 到 等 待 超时 或 发 现 可 弹出 元 素 为 止 。 


当 给 定 多 个 key 参数 时 ， 按 参数 key 的 先后 顺序 依次 检查 各 个 列表 ， 弹 出 第 一 个 非 空 列 表 
的 头 元 素 。 


非 阻塞 行为 

当 BLPOP 被 调用 时 ， 如 果 给 定 key 内 至 少 有 一 个 非 空 列表 ， 那 么 弹出 遇 到 的 第 一 个 非 空 列 
表 的 头 元 素 ， 并 和 被 弹出 元 素 所 属 的 列表 的 名 字 一 起 ， 组 成 结果 返回 给 调用 者 。 

当 存 在 多 个 给 定 key 时 ， BLPOP HAE key 参数 排列 的 先后 顺序 ， 依 次 检查 各 个 列表 。 


假设 现在 有 job 、 command 和 request 三 个 列表 ， 其 中 job AH, command 和 
request 都 持 有 非 空 列表 。 考 虑 以 下 命令 : 


BLPOP job command request 0 


BLPOP 保证 返回 的 元 素来 自 command ， 因 为 它 是 按 "查找 job -> 查找 command -> 查找 
request “这 样 的 顺序 ， 第 一 个 找到 的 非 空 列表 。 


redis> DEL job command request # 确保 key 都 被 删除 

(integer) 0 

redis> LPUSH command "update system..." # 为 command 列 表 增 加 一 个 值 

(integer) 1 

redis> LPUSH request "visit page" # 为 request 列 表 增 加 一 个 值 

(integer) 1 

redis> BLPOP job command request 0 # job 列表 为 空 ， 被 跳 过 ， 紧 接着 command 列表 的 第 一 个 元 素 
1) "command" # 弹出 元 素 所 属 的 列表 

2) "update system..." # 弹出 元 素 所 属 的 值 





阻塞 行为 
如 果 所 有 给 定 key 都 不 存在 或 包含 空 列表 ， 那 么 BLPOP 命令 将 阻塞 连接 ， 直 到 等 待 超时 ， 
或 有 另 一 个 客户 端 对 给 定 key 的 任意 一 个 执行 LPUSH 或 RPUSH 命令 为 止 。 


超时 参数 timeout 接受 一 个 以 秒 为 单位 的 数字 作为 值 。 超 时 参数 设 为 。 表示 阻塞 时 间 可 以 
无 限期 延长 (block indefinitely) 。 


redis> EXISTS job # 确保 两 个 key 都 不 存在 
(integer) 6 

redis> EXISTS command 

(integer) 0 


redis> BLPOP job command 300 # 因为 key 一 开始 不 存在 ， 所 以 操作 会 被 阻塞 ， 直 到 另 一 客户 端 对 job x7 


1) "job" # 这 里 被 push 的 是 job 
2) "do my home work" # 被 弹出 的 值 

)26.265( # 等 待 的 秒 数 

redis> BLPOP job command 5 # 等 待 超时 的 情况 

(nil) 

(5.66s) # 等 待 的 秒 数 


«| a 








相同 的 key 被 多 个 客户 端 同时 阻塞 
相同 的 key 可 以 被 多 个 客户 端 同时 阻塞 。 


不 同 的 客户 端 被 放 进 一 个 队列 中 ， 按 『 先 阻塞 先 服 务 4 (firstBLPOP，first-served) 的 顺序 为 
key 执行 BLPOP AS. 


在 MULTI/EXEC 事 务 中 的 BLPOP 


BLPOP 可 以 用 于 流水 线 (pipline, 批 量 地 发 送 多 个 命令 并 读 和 人 多 个 回复 )， 但 把 它 用 在 MULTI/ 
EXEC 块 当中 没有 意义 。 因 为 这 要 求 整 个 服务 器 被 阻塞 以 保证 块 执 行 时 的 原子 性 ， 该 行为 阻 
止 了 其 他 客户 端 执 行 LPUSH 或 RPUSH RD. 


因此 ， 一 个 被 包 误 在 MULTI / EXEC 块 内 的 BLPOP 命令 ， 行 为 表现 得 就 像 LPOP 一 样 ， 对 
空 列表 返回 nil ， 对 非 空 列表 弹出 列表 元 素 ， 不 进行 任何 阻塞 操作 。 


# 对 非 空 列表 进行 操作 


redis> RPUSH job programming 
(integer) 1 


redis> MULTI 
OK 


redis> BLPOP job 30 
QUEUED 


redis> EXEC # 不 阻塞 ， 立 即 返回 
1) 1) "job" 
2) "programming" 


# 对 空 列 表 进 行 操作 


redis> LLEN job # 空 列表 
(integer) 0 


redis> MULTI 
OK 


redis> BLPOP job 30 
QUEUED 


redis> EXEC # 不 阻塞 ， 立 即 返回 
1) (nil) 


可 用 版 本 : 
>= 2.0.0 

at SRE: 
O(1) 

返回 值 : 


如 果 列 表 为 空 ， 返 回 一 个 nil 。 否 则 ， 返 回 一 个 含有 两 个 元 素 的 列表 ， 第 一 个 元 素 是 被 弹出 
元 素 所 属 的 key ， 第 二 个 元 素 是 被 弹出 元 素 的 值 。 


模式 : 事件 提醒 
有 时 候 ， 为 了 等 待 一 个 新 元 素 到 达 数 据 中 ， 需 要 使 用 轮 询 的 方式 对 数据 进行 探查 。 


另 一 种 更 好 的 方式 是 ， 使 用 系统 提供 的 阻塞 原 语 ， 在 新 元 素 到 达 时 立即 进行 处 理 ， 而 新 元 素 
还 没 到 达 时 ， 就 一 直 阻塞 住 ， 避 免 轮 询 占用 资源 。 


对 于 Redis ， 我 们 似乎 需要 一 个 阻塞 版 的 SPOP RS, (AXEL, A BLPOP 或 者 
BRPOP 就 能 很 好 地 解决 这 个 问题 。 


使 用 元 素 的 客户 端 (消费 者 ) 可 以 执行 类 似 以 下 的 代码 : 


LOOP forever 
WHILE SPOP(key) returns elements 
. process elements ... 
END 
BRPOP helper_key 
END 


添加 元 素 的 客户 端 (消费 者 ) 则 执行 以 下 代码 : 


MULTI 
SADD key element 
LPUSH helper_key x 
EXEC 


BRPOP 


BRPOP key [key ...[ timeout 
BRPOP 是 列表 的 阻塞 式 (blocking) 漳 出 原 语 。 


它 是 RPOP 命令 的 阻塞 版 本 ， 当 给 定 列表 内 没有 任何 元 素 可 供 漳 出 的 时 候 ， 连 接 将 被 
BRPOP 命令 阻塞 ， 直 到 等 待 超时 或 发 现 可 弹出 元 素 为 止 。 


当 给 定 多 个 key 参数 时 ， 按 参数 key 的 先后 顺序 依次 检查 各 个 列表 ， 弹 出 第 一 个 非 空 列 表 
的 尾部 元 素 。 


关于 阻塞 操作 的 更 多 信息 ， 请 查看 BLPOP RB, BRPOP 除了 弹出 元 素 的 位 置 和 BLPOP 不 
同 之 外 ， 其 他 表现 一 致 。 


可 用 版 本 : 
>= 2.0.0 

时 间 复 条 度 : 
O(1) 

返回 值 : 


假如 在 指定 时 间 内 没有 任何 元 素 被 弹出 ， 则 返回 一 个 nil 和 等 待 时 长 。 反 之 ， 返 回 一 个 含有 
两 个 元 素 的 列表 ， 第 一 个 元 素 是 被 弹出 元 素 所 属 的 key ， 第 二 个 元 素 是 被 弹出 元 素 的 值 。 


redis> LLEN course 
(integer) 0 


redis> RPUSH course algorithm001 
(integer) 1 


redis> RPUSH course c++101 
(integer) 2 


redis> BRPOP course 30 
1) "course" # 被 弹出 元 素 所 属 的 列表 键 
2) "c++101" # 被 弹出 的 元 素 


BRPOPLPUSH 


BRPOPLPUSH source destination timeout 


BRPOPLPUSH 是 RPOPLPUSH 的 阻塞 版 本 ， 当 给 定 列表 source 不 为 空 时 ， 
BRPOPLPUSH 的 表现 和 RPOPLPUSH —#. 


当 列 表 source 为 空 时 ， BRPOPLPUSH 命令 将 阻塞 连接 ， 直 到 等 待 超时 ， 或 有 另 一 个 客户 
端 对 source 执行 LPUSH 或 RPUSH 命令 为 止 。 


超时 参数 timeout 接受 一 个 以 秒 为 单位 的 数字 作为 值 。 超 时 参数 设 为 6 表示 阻塞 时 间 可 以 
无 限期 延长 (block indefinitely) 。 


更 多 相关 信息 ， 请 参考 RPOPLPUSH RADo 
可 用 版 本 : 

>= 2.2.0 

THERE: 

O(1) 

返回 值 : 


假如 在 指定 时 间 内 没有 任何 元 素 被 弹出 ， 则 返回 一 个 nil 和 等 待 时 长 。 反 之 ， 返 回 一 个 含有 
两 个 元 素 的 列表 ， 第 一 个 元 素 是 被 弹出 元 素 的 值 ， 第 二 个 元 素 是 等 待 时 长 。 


# 非 空 列表 

redis> BRPOPLPUSH msg reciver 500 

"hello moto" # 弹出 元 素 的 值 
(3.38s) # 等 待 时 长 


redis> LLEN reciver 
(integer) 1 


redis> LRANGE reciver 0 0 
1) "hello moto" 


# 空 列 表 
redis> BRPOPLPUSH msg reciver 1 


(nil) 
(1.34s) 


模式 : 安全 队列 


参考 RPOPLPUSH 命令 的 『 安 全 队列 上 模式。 


模式 : 循环 列表 


参考 RPOPLPUSH 命令 的 『 循 环 列 表 」 模式 。 


LINDEX 


LINDEX key index 
返回 列表 key 中 ， 下 标 为 index 的 元 素 。 


下 标 (index) 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 6 表示 列表 的 第 一 个 元 素 ， 
以 1 表示 列表 的 第 二 个 元 素 ， 以 此 类 推 。 


你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 列表 的 最 后 一 个 元 素 ， -2 表示 列表 的 倒数 第 二 个 元 
素 ， 以 此 类 推 。 


如 果 key 不 是 列表 类 型 ， 返 回 一 个 错误 。 
可 用 版 本 : 

>= 1.0.0 

at SRE: 


O(N), n 为 到 达 下 标 index 过 程 中 经 过 的 元 素数 量 。 因 此 ， 对 列表 的 头 元 素 和 尾 元 素 执 行 
LINDEX 命令 ， 复 条 度 为 O(1)。 


返回 值 : 


列表 中 下 标 为 index 的 元 素 。 如 果 index 参数 的 值 不 在 列表 的 区 间 范 围 内 (out of range), 
返回 nil o 

redis> LPUSH mylist "World" 

(integer) 1 


redis> LPUSH mylist "Hello" 
(integer) 2 


redis> LINDEX mylist 0 
"Hello" 


redis> LINDEX mylist -1 
"World" 


redis> LINDEX mylist 3 # index 不 在 mylist 的 区 间 范 围 内 
(nil) 


LINSERT 


LINSERT key BEFORE|AFTER pivot value 


将 值 value 插入 到 列表 key 4H, MFM pivot 之 前 或 之 后 。 


当 pivot 不 存在 于 列表 key 时 ， 不 执行 任何 操作 。 


4 key 不 存在 时 ， key 被 视 为 空 列表 ， 不 执行 任何 操作 。 


如 果 key 不 是 列表 类 型 ， 返 回 一 个 错误 。 

可 用 版 本 : 

>= 2.2.0 

时 间 复 条 度 : 

O(N), n 为 寻找 pivot 过 程 中 经 过 的 元 素数 量 。 
返回 值 : 


如 果 命 令 执 行 成 功 ， 返 回 插 入 操作 完成 之 后 ， 列 表 的 长 度 。 
。 如 果 key 不 存在 或 为 空 列 表 ， 返 回 © 。 


redis> RPUSH mylist "Hello" 
(integer) 1 


redis> RPUSH mylist "World" 
(integer) 2 


redis> LINSERT mylist BEFORE "World" "There" 
(integer) 3 


redis> LRANGE mylist 0 -1 


1) "Hello" 
2) "There" 
3) "World" 


# 对 一 个 非 空 列表 插入 ， 坦 找 一 个 不 存在 的 pivot 


redis> LINSERT mylist BEFORE "go" "let's" 
(integer) -1 # 失败 


# 对 一 个 空 列表 执行 LINSERT AP 


redis> EXISTS fake_list 
(integer) 0 


redis> LINSERT fake_list BEFORE "nono" "gogogog" 
(integer) 0 # 失败 


如 果 没 有 找到 pivot و‎ 返回 


LLEN 


LLEN key 

返回 列表 key 的 长 度 。 
如 果 key 不 存在 ， 则 key 被 解释 为 一 个 空 列 表 ， 返 回 o. 
如 果 key 不 是 列表 类 型 ， 返 回 一 个 错误 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复杂 度 : 

O(1) 

返回 值 : 

列表 key 的 长 度 。 


# 空 列表 


redis> LLEN job 
(integer) 0 


# 非 空 列表 


redis> LPUSH job "cook food" 
(integer) 1 


redis> LPUSH job "have lunch" 
(integer) 2 


redis> LLEN job 
(integer) 2 


LPOP 


LPOP key 

移 除 并 返回 列表 key 的 头 元 素 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

列表 的 头 元 素 。 当 key BER, iG] nil o 


redis> LLEN course 
(integer) 0 


redis> RPUSH course algorithm001 
(integer) 1 


redis> RPUSH course c++101 
(integer) 2 


redis> LPOP course # BRATR 
"algorithm001" 


LPUSH 


LPUSH key value [value ...] 
将 一 个 或 多 个 值 value 插入 到 列表 key 的 表 头 


如 果 有 多 个 value 4, BABS value 值 按 从 左 到 右 的 顺序 依次 插入 到 表 头 : 比如 说 ， 对 
空 列 表 mylist 执行 命令 LPUSH mylist abc ， 列 表 的 值 将 是 c bp a ， 这 等 同 于 原子 性 地 


执行 LPUSH mylist a 、 LPUSH mylist b 和 LPUSH mylist c 三 个 命令 。 
如 果 key 不 存在 ， 一 个 空 列表 会 被 创建 并 执行 LPUSH 操作 。 
كك‎ key 存在 但 不 是 列表 类 型 时 ， 返 回 一 个 错误 。 

Note 

在 Redis 2.4 版 本 以 前 的 LPUSH 命令 ， 都 只 接受 单个 value 值 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

执行 LPUSH 命令 后 ， 列 表 的 长 度 。 


# 加 入 单个 元 素 


redis> LPUSH languages python 
(integer) 1 


# 加 入 重复 元 素 


redis> LPUSH languages python 
(integer) 2 


redis> LRANGE languages © -1 # 列表 人 允许 重复 元 素 
1) "python" 
2) "python" 


# 加 入 多 个 元 素 


redis> LPUSH mylist a bc 
(integer) 3 


redis> LRANGE mylist 0 -1 
1) Wel 
2) Mbt 
3) mas 


LRANGE 


LRANGE key start stop 
返回 列表 key 中 指定 区 间 内 的 元 素 ， 区 间 以 偏 移 量 start 和 stop 指定 。 


下 标 (index) 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 6 表示 列表 的 第 一 个 元 素 ， 
以 1 表示 列表 的 第 二 个 元 素 ， 以 此 类 推 。 


你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 列表 的 最 后 一 个 元 素 ， -2 表示 列表 的 倒数 第 二 个 元 
素 ， 以 此 类 推 。 


注意 LRANGE 命 信和 编程 语言 区 间 本 数 的 区 别 


假如 你 有 一 个 包含 一 百 个 元 素 的 列表 ， 对 该 列表 执行 LRANGE list 010 ， 结 果 是 一 个 包含 11 
个 元 素 的 列表 ， 这 表明 stop 下 标 也 在 LRANGE 命令 的 取 值 范围 之 内 ( 闭 区 间 )， 这 和 某 些 语 
襄 的 区 间 画 数 可 能 不 一 致 ， 比 如 Ruby 的 range.new 、 Array#slice 和 Python 的 range) ذا‎ 
数 。 


超出 范围 的 下 标 
超出 范围 的 下 标 值 不 会 引起 错误 。 


如 果 start 下 标 比 列表 的 最 大 下 标 end ) LLEN list MA 1 ) 还 要 大 ， 那 么 LRANGE 返 
回 一 个 空 列表 。 


如 果 stop 下 标 比 end 下 标 还 要 大 ，Redis 将 stop 的 值 设置 为 end o 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(S+N)， s 为 偏 移 量 start, AN 为 指定 区 间 内 元 素 的 数量 。 
返回 值 : 

一 个 列表 ， 包 含 指定 区 间 内 的 元 素 。 


redis> RPUSH fp-language lisp 
(integer) 1 


redis> LRANGE fp-language 0 0 
1) "lisp" 


redis> RPUSH fp-language scheme 
(integer) 2 


redis> LRANGE fp-language © 1 
1) "lisp" 
2) "scheme" 


LREM 


LREM key count value 
根据 参数 count 的 值 ， 移 除 列 表 中 与 参数 value 相等 的 元 素 。 
count 的 值 可 以 是 以 下 几 种 : 


© count &gt; 6 : 从 表 头 开始 向 表 尾 搜索 ， 移 除 与 value 相等 的 元 素 ， 数量 为 count o 

© count &lt; 0 : 从 表 尾 开始 向 表 头 搜索 ， 移 除 与 value 相等 的 元 素 ， 数量 为 count 的 
绝对 值 。 

e count = 6 : 移 除 表 中 所 有 与 value 相等 的 值 。 


可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N), n 为 列表 的 长 度 。 

返回 值 : 

被 移 除 元 素 的 数量 。 因 为 不 存在 的 key 被 视 作 空 表 (empty list)， 所 以 当 key 不 存在 时 ， 


LREM 命令 总 是 返回 o o 


# 先 创建 一 个 表 ， 内 容 排列 是 


# morning hello morning helllo morning 


redis> LPUSH greet "morning" 
(integer) 1 

redis> LPUSH greet "hello" 
(integer) 2 

redis> LPUSH greet "morning" 
(integer) 3 

redis> LPUSH greet "hello" 
(integer) 4 

redis> LPUSH greet "morning" 
(integer) 5 





redis> LRANGE greet 0 4 # 查看 所 有 元 素 

1) "morning" 

2) "hello" 

3) "morning" 

4) "hello" 

5) "morning" 

redis> LREM greet 2 morning # 移 除 从 表 头 到 表 尾 ， 最 先 发 现 的 两 个 morning 
(integer) 2 H 两 个 元 素 被 移 除 

redis> LLEN greet # 还 剩 3 个 元 素 


(integer) 3 


redis> LRANGE greet 0 2 
1) "hello" 

2) "hello" 

3) "morning" 


redis> LREM greet -1 morning # 移 除 从 表 尾 到 表 头 ， 第 一 个 morning 
(integer) 1 


redis> LLEN greet # 剩 下 两 个 元 素 
(integer) 2 


redis> LRANGE greet 0 1 


1) "hello" 
2) "hello" 
redis> LREM greet © hello # 移 除 表 中 所 有 hello 
(integer) 2 # 两 个 hello 被 移 除 


redis> LLEN greet 
(integer) 0 


LSET 


LSET key index value 


将 列表 key 下 标 为 index 的 元 素 的 值 设置 为 value o 


当 index 参数 超出 范围 ， 或 对 一 个 空 列表 ( key 不 存在 ) 进 


行 LSET 时 ， 


关于 列表 下 标的 更 多 信息 ， 请 参考 LINDEX BF. 


可 用 版 本 : 

>= 1.0.0 

at SRE: 

对 头 元 素 或 尾 元 素 进 


度 。 
返回 值 : 
操作 成 功 返 ok ， 否 则 返回 错误 信息 。 


# 对 空 列表 (key 不 存在 ) 进 行 LSET 


redis> EXISTS list 
(integer) 0 


redis> LSET list 0 item 
(error) ERR no such key 


# 对 非 空 列 表 进 行 LSET 


redis> LPUSH job "cook food" 
(integer) 1 


redis> LRANGE job © 0 
1) "cook food" 


redis> LSET job 0 "play game" 
OK 


redis> LRANGE job 0 0 
1) "play game" 


# index 超出 范围 


redis> LLEN list 
(integer) 1 


redis> LSET list 3 'out of range' 
(error) ERR index out of range 


47 LSET 操作 ， 复 条 度 为 


O(1)。 其 他 情况 下 ， 为 O(N), 


# 列表 长 度 为 1 


返回 一 


个 错 i 误 。 


N 为 列表 的 长 


LTRIM 


LTRIM key start stop 


对 一 个 列表 进行 修剪 (trim)， 就 是 说 ， 让 列表 只 保留 指定 区 间 内 的 元 素 ， 不 在 指定 区 间 之 内 的 
元 素 都 将 被 删除 。 


举 个 例子 ， 执 行 命令 LTRIM list 02 ， 表 示 只 保留 列表 list 的 前 三 个 元 素 ， 其 余 元 素 全 
部 删除 。 


下 标 (index) 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 6 表示 列表 的 第 一 个 元 素 ， 
以 1 表示 列表 的 第 二 个 元 素 ， 以 此 类 推 。 


你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 列表 的 最 后 一 个 元 素 ， -2 表示 列表 的 倒数 第 二 个 元 
素 ， 以 此 类 推 。 


当 key 不 是 列表 类 型 时 ， 返回 一 个 错误 。 
LTRIM 命令 通常 和 LPUSH 命令 或 RPUSH 命令 配合 使 用 ， 举 个 例子 : 


LPUSH log newest_log 
LTRIM log © 99 


这 个 例子 模拟 了 一 个 日 志 程 序 ， 每 次 将 最 新 日 志 newest_log 放 到 log 列表 中 ， 并 且 只 保留 
最 新 的 100 项 。 注 意 当 这 样 使 用 LTRIM 命令 时 ， 时 间 复 杂 度 是 O(1)， 因 为 平均 情况 下 ， 每 
次 只 有 一 个 元 素 被 移 除 。 


注意 LTRIM 命 舍 和 编程 语言 区 间 辑 数 的 区 别 


假如 你 有 一 个 包含 一 百 个 元 素 的 列表 list ， 对 该 列表 执行 LTRIM list 9 10 ， 结 果 是 一 个 
包含 11 个 元 素 的 列表 ， 这 表明 stop 下 标 也 在 LTRIM 命令 的 取 值 范围 之 内 ( 闭 区 间 )， 这 和 某 
些 语言 的 区 间 图 数 可 能 不 一 致 ， 比 如 Ruby 的 range.new 、 Array#slice 和 Python 的 
range() AR. 


超出 范围 的 下 标 
超出 范围 的 下 标 值 不 会 引起 错误 。 


如 果 start 下 标 比 列表 的 最 大 下 标 end ) LLEN list MA 1 ) 还 要 大 ， 或 者 
start &gt; stop , LTRIM 返回 一 个 空 列表 (因为 LTRIM 已 经 将 整个 列表 清空 )。 


如 果 stop 下 标 比 end 下 标 还 要 大 ，Redis 将 stop 的 值 设置 为 end o 
可 用 版 本 : 


>= 1.0.0 


时 间 复 杂 度 : 
O(N), n 为 被 移 除 的 元 素 的 数量 。 


~ 


返回 值 : 
命令 执行 成 功 时 ， 返 回 ok o 


# 情况 1: 常见 情况 ， start 和 stop 都 在 列表 的 索引 范围 之 内 


redis> LRANGE alpha © -1 # alpha 是 一 个 包含 5 个 字符 串 的 列表 
1) DH a M 

2) wall 

3) لفن‎ Gi 

ال )4 

5( 8 

redis> LTRIM alpha 1 -1 # 删除 alpha 列表 索引 为 0 的 元 素 
OK 

redis> LRANGE alpha © -1 # "h" 被 删除 了 

1) Nel 

2) Da ا‎ 

3) Beg py 

4) Wee 


# 情况 2: stop 比 列 表 的 最 大 下 标 还 要 大 


redis> LTRIM alpha 1 10086 # 保留 alpha 列表 索引 1 BRS] 10086 上 的 元 素 
OK 

redis> LRANGE alpha © -1 # 只 有 索引 0 上 的 元 素 "e" 被 删除 了 ， 其 他 元 素 还 在 
1) يدا اذا‎ 

2) a By 

3) Wo" 


# 情况 3: start 和 stop 都 比 列表 的 最 大 下 标 要 大 ， 并 且 start < stop 


redis> LTRIM alpha 10086 123321 
OK 


redis> LRANGE alpha © -1 # 列表 被 清空 
(empty list or set) 


# 情况 4: start 和 stop 都 比 列表 的 最 大 下 标 要 大 ， 并 且 start > stop 


redis> RPUSH new-alpha "h" "e" "1" "I" "o" # 重新 建立 一 个 新 列表 
(integer) 5 


redis> LRANGE new-alpha 0 -1 


1) DU ay 

2) Nel 

3) a يا‎ 

4) a By 

5) Wow 

redis> LTRIM new-alpha 123321 10086 # 执行 LTRIM 
OK 

redis> LRANGE new-alpha © -1 # 同样 被 清空 


(empty list or set) 


RPOP 


RPOP key 

移 除 并 返回 列表 key 的 尾 元 素 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

列表 的 尾 元 素 。 当 key 不 存在 时 ， 返 回 nil o 


redis> RPUSH mylist "one" 
(integer) 1 


redis> RPUSH mylist "two" 
(integer) 2 


redis> RPUSH mylist "three" 
(integer) 3 


redis> RPOP mylist # 返回 被 弹出 的 元 素 
"three" 


redis> LRANGE mylist © -1 # 列表 剩 下 的 元 素 
1) "one" 
2) "two" 


RPOPLPUSH 


RPOPLPUSH source destination 
命令 RPOPLPUSH 在 一 个 原子 时 间 内 ， 执 行 以 下 两 个 动作 : 


。 将 列表 source 中 的 最 后 一 个 元 素 ( 尾 元 素 ) 弹 出 ， 并 返回 给 客户 端 。 
° 将 source 弹出 的 元 素 插 入 到 列表 destination و‎ 作为 destination 列表 的 的 头 元 素 。 


举 个 例子 ， 你 有 两 个 列表 source 和 destination و‎ source 列表 有 元 素 20 6, 6 | و‎ 
destination 列表 有 元 素 Xy و اح‎ 执行 RPOPLPUSH source destination 之 后 ， source 列 
表 包 含 元 素 a,b, destination 列表 包含 元 素 c，x，y，z ， 并 且 元 素 c 会 被 返回 给 客 
户 端 。 

如 果 source 不 存在 ， 值 nil 被 返回 ， 并 且 不 执行 其 他 动作 。 


如 果 source 和 destination 相同 ， 则 列表 中 的 表 尾 元 素 被 移动 到 表 头 ， 并 返回 该 元 素 ， 可 
以 把 这 种 特殊 情况 视 作 列表 的 旋转 (rotation) 操 作 。 


可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 
O(1) 

返回 值 : 

被 漳 出 的 元 素 。 


# Source 和 destination 不 同 


redis> 
1) Waitt 
2) ME 
3) Welt 
4) يا‎ 
redis> 
walt 

redis> 
1) Tait 
2) Witt 
3) non 
redis> 
1) Walt 
redis> 
Welt 

redis> 
1) ae 
2) Mit 
redis> 
1) RCR 
2) Mra |l 


LRANGE alpha © -1 # 查看 所 有 元 素 


RPOPLPUSH alpha reciver # 执行 一 次 RPOPLPUSH 看 看 


LRANGE alpha © -1 


LRANGE reciver 0 -1 


RPOPLPUSH alpha reciver # 再 执行 一 次 ， 证 实 RPOP 和 LPUSH 的 位 置 正 确 


LRANGE alpha © -1 


LRANGE reciver 0 -1 


# source 和 destination 相同 


redis> 
1) a Eu 
2) Neo i 
3) TaN 
4) mAN 
redis> 
Wate 

redis> 
1) ma 
2) ey وملا‎ 
3) Nie YU 
4) ngn 
redis> 
Wey 

redis> 
1) TaN 
2) AN 
3) Me Eu 
4) Nei 


模式 


Redis 的 列表 经 常 被 用 作 队 列 (queue)， 用 于 在 不 同 程序 之 间 有 序 地 交换 消息 (message)。 一 个 
客户 端 通过 LPUSH 命令 将 消息 放 人 队列 中 ， 而 另 一 个 客户 端 通过 RPOP 或 者 BRPOP AR 


LRANGE number © -1 


RPOPLPUSH number number 


LRANGE number © -1 # 4 被 旋转 到 了 表 头 


RPOPLPUSH number number 


LRANGE number © -1 # 这 次 是 3 被 旋转 到 了 表 头 


: 安全 的 队列 


取出 队列 中 等 待 时 间 最 长 的 消息 。 


不 幸 的 是 ， 上 面 的 队列 方法 是 『 不 安全 4 的 ， 因 为 在 这 个 过 程 中 ， 一 个 客户 端 可 能 在 取出 一 
个 消息 之 后 崩溃 ， 而 未 义理 完 的 消息 也 就 因此 丢失 。 


使 用 RPOPLPUSH 命令 (或 者 它 的 阻塞 版 本 BRPOPLPUSH ) 可 以 解决 这 个 问题 : 因为 它 不 仅 
返回 一 个 消息 ， 同 时 还 将 这 个 消息 添加 到 另 一 个 备份 列表 当中 ， 如 果 一 切 正常 的 话 ， 当 一 个 
客户 端 完成 某 个 消息 的 处 理 之 后 ， 可 以 用 LREM 命令 将 这 个 消息 从 备份 表 删 除 。 


最 后 ， 还 可 以 添加 一 个 客户 端 专门 用 于 监视 备份 表 ， 它 自动 地 将 超过 一 定 处 理 时 限 的 消息 重 
新 放 入 队列 中 去 (负责 处 理 该 消息 的 客户 端 可 能 已 经 崩溃 )， 这 样 就 不 会 丢失 任何 消息 了 。 


模式 : 循环 列表 


通过 使 用 相同 的 key 作为 RPOPLPUSH 命令 的 两 个 参数 ， 客 户 端 可 以 用 一 个 接 一 个 地 获取 
列表 元 素 的 方式 ， 取 得 列表 的 所 有 元 素 ， 而 不 必 像 LRANGE 命 合 那 祥 一 下 子 将 所 有 列表 元 素 
都 从 服务 器 传送 到 客户 端 中 (两 种 方式 的 总 复 条 度 都 是 O(N))。 


以 上 的 模式 甚至 在 以 下 的 两 个 情况 下 也 能 正常 工作 : 


٠ 有 多 个 客户 端 同时 对 同一 个 列表 进行 旋转 (rotating)， 它 们 获取 不 同 的 元 素 ， 直 到 所 有 元 
素 都 被 读 取 完 ， 之 后 又 从 头 开始 。 
٠ 有 客户 端 在 向 列表 尾部 (右边 ) 添 加 新 元 素 。 


这 个 模式 使 得 我 们 可 以 很 容易 实现 这 样 一 类 系统 : 有 N 个 客户 端 ， 需 要 连续 不 断 地 对 一 些 元 
素 进 行 处 理 ， 而 且 义 理 的 过 程 必 须 尽 可 能 地 快 。 一 个 典型 的 例子 就 是 服务 器 的 监控 程序 : ص‎ 
们 需要 在 尽 可 能 短 的 时 间 内 ， 并 行 地 检查 一 组 网 站 ， 确 保 它们 的 可 访问 性 。 


注意 ， 使 用 这 个 模式 的 客户 端 是 易于 扩展 (scala) 且 安全 (reliable) 的 ， 因 为 就 算 接收 到 元 素 的 客 
户 端 失败 ， 元 素 还 是 保存 在 列表 里 面 ， 不 会 丢失 ， 等 到 下 个 迭代 来 临 的 时 候 ， 别 的 客户 端 又 
可 以 继续 处 理 这 些 元 素 了 。 


RPUSH 


RPUSH key value [value …] 
将 一 个 或 多 个 值 value 插入 到 列表 key 的 表 尾 (最 右边 2 


如 果 有 多 个 value 值 ， 那 么 各 个 value 值 按 从 左 到 右 的 顺序 依次 插入 到 表 尾 : 比如 对 一 个 
空 列表 mylist 执行 RPUSH mylist abc و‎ 得 出 的 结果 列表 为 abc ， 等 同 于 执行 命令 


RPUSH mylist a 、 RPUSH mylist b . RPUSH mylist c o 

如 果 key 不 存在 ， 一 个 空 列表 会 被 创建 并 执行 RPUSH 操作 。 

当 key 存在 但 不 是 列表 类 型 时 ， 返 回 一 个 错误 。 

Note 

在 Redis 2.4 版 本 以 前 的 RPUSH 命 合 ， 都 只 接受 单个 value 值 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 


O(1) 


执行 RPUSH 操作 后 ， 表 的 长 度 。 


# 添加 单个 元 素 


redis> RPUSH languages © 
(integer) 1 


# 添加 重复 元 素 


redis> RPUSH Languages © 
(integer) 2 


redis> LRANGE languages 0 -1 # 列表 人 允许 重复 元 素 
1) es 
2) TER 


# 添加 多 个 元 素 


redis> RPUSH mylist a b c 
(integer) 3 


redis> LRANGE mylist 0 -1 
1) wae 
2) "hn 
3) Teu 


RPUSHX 


RPUSHX key value 

将 值 value 插入 到 列表 key HARE, SARS key 存在 并 且 是 一 个 列表 。 
和 RPUSH 命令 相反 ， 当 key 不 存在 时 ， RPUSHX 命令 什么 也 不 做 。 

可 用 版 本 : 

>= 2.2.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

RPUSHX 命令 执行 之 后 ， 表 的 长 度 。 


# key 不 存在 


redis> LLEN greet 
(integer) 0 


redis> RPUSHX greet "hello" # 对 不 存在 的 key 进行 RPUSHX，PUSH 失败 。 
(integer) 0 


# key 存在 且 是 一 个 非 空 列表 


redis> RPUSH greet "hi" # 先 用 RPUSH 插入 一 个 元 素 
(integer) 1 


redis> RPUSHX greet "hello" # greet 现在 是 一 个 列表 类 型 ，RPUSHX 操作 成 功 。 
(integer) 2 


redis> LRANGE greet 0 -1 
1) دب‎ pa 
2) "hello" 


Set (集合 ) 


SADD 


SADD key member [member ...[ 


将 一 个 或 多 个 member 元 素 加 入 到 集合 key 当中 ， 已 经 存在 于 集合 的 member 元 素 将 被 忽 
略 。 


假如 key 不 存在 ， 则 创建 一 个 只 包含 member 元 素 作成 员 的 集合 。 
当 key 不 是 集合 类 型 时 ， 返 回 一 个 错误 。 

Note 

在 Redis2.4 版 本 以 前 ， SADD 只 接受 单个 member 值 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N), n 是 被 添加 的 元 素 的 数量 。 

返回 值 : 

被 添加 到 集合 中 的 新 元 素 的 数量 ， 不 包括 被 忽略 的 元 素 。 


# 添加 单个 元 素 


redis> SADD bbs "discuz.net" 
(integer) 1 


# 添加 重复 元 素 


redis> SADD bbs "discuz.net" 
(integer) 0 


# 添加 多 个 元 素 


redis> SADD bbs "tianya.cn" "groups.google.com" 
(integer) 2 


redis> SMEMBERS bbs 

1) "discuz.net" 

2) "groups.google.com" 
3) "tianya.cn" 


SCARD 


SCARD key 

返回 集合 key 的 基数 (集合 中 元 素 的 数量 )。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

集合 的 基数 。 当 key PFE, RE @ 。 


redis> SADD tool pc printer phone 
(integer) 3 


redis> SCARD tool # 非 空 集合 
(integer) 3 


redis> DEL tool 
(integer) 1 


redis> SCARD tool # 空 集合 
(integer) 0 


SDIFF 


SDIFF key [key ...] 

返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 之 间 的 差 集 。 
不 存在 的 key 被 视 为 空 集 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N), n 是 所 有 给 定 集合 的 成 员 数 量 之 和 。 


返回 值 
جم‎ 
一 个 包含 差 集成 员 的 列表 。 
redis> SMEMBERS peter's_movies 
1) "bet man" 
2) "start war" 
3) "2012" 
redis> SMEMBERS joe's_movies 
1) "hi, lady" 
2) "Fast Five" 
3) "2012" 


redis> SDIFF peter's_movies joe's_movies 
1) "bet man" 
2) "start war" 


SDIFFSTORE 


SDIFFSTORE destination key [key ...] 


这 个 命令 的 作用 和 SDIFF 类 似 ， 但 它 将 结果 保存 到 destination 集合 ， 而 不 是 简单 地 返回 结 
果 集 。 


如 果 destination 集合 已 经 存在 ， 则 将 其 覆盖 。 
destination 可 以 是 key 本 身 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N), n 是 所 有 给 定 集合 的 成 员 数 量 之 和 。 


返回 值 : 
结果 集中 的 元 素数 量 。 
redis> SMEMBERS joe's_movies 
1) "hi, lady" 
2) "Fast Five" 
3) "2012" 
redis> SMEMBERS peter's_ movies 
1) "bet man" 
2) "start war" 
3) "2012" 


redis> SDIFFSTORE joe_diff_peter joe's_movies peter's_movies 
(integer) 2 


redis> SMEMBERS joe_diff_peter 
1) "hi, lady" 
2) "Fast Five" 


SINTER 


SINTER key [key ...] 

返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 的 交集 。 

不 存在 的 key 被 视 为 空 集 。 

当 给 定 集合 当中 有 一 个 空 集 时 ， 结 果 也 为 空 集 (根据 集合 运算 定律 )。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N*M), n 为 给 定 集合 当中 基数 最 小 的 集合 ， M 为 给 定 集合 的 个 数 。 
返回 值 : 

交集 成 员 的 列表 。 


redis> SMEMBERS group_1 
1) "LI LEI" 

2) "TOM" 

3) "JACK" 


redis> SMEMBERS group_2 
1) "HAN MEIMEI" 
2) "JACK" 


redis> SINTER group_1 group_2 
1) "JACK" 


SINTER 


SINTER key [key ...] 

返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 的 交集 。 

不 存在 的 key 被 视 为 空 集 。 

当 给 定 集合 当中 有 一 个 空 集 时 ， 结 果 也 为 空 集 (根据 集合 运算 定律 )。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N*M), n 为 给 定 集合 当中 基数 最 小 的 集合 ， M 为 给 定 集合 的 个 数 。 
返回 值 : 

交集 成 员 的 列表 。 


redis> SMEMBERS group_1 
1) "LI LEI" 

2) "TOM" 

3) "JACK" 


redis> SMEMBERS group_2 
1) "HAN MEIMEI" 
2) "JACK" 


redis> SINTER group_1 group_2 
1) "JACK" 


SINTERSTORE 


SINTERSTORE destination key [key ...[ 


这 个 命令 类 似 于 SINTER 命令 ， 但 它 将 结果 保存 到 destination 集合 ， 而 不 是 简单 地 返回 结 
果 集 。 


如 果 destination 集合 已 经 存在 ， 则 将 其 覆盖 。 

destination 可 以 是 key 本 身 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N*M), AN 为 给 定 集合 当中 基数 最 小 的 集合 ， Mm 为 给 定 集合 的 个 数 。 


返回 值 : 
结果 集中 的 成 员 数 量 。 


redis> SMEMBERS songs 
1) "good bye joe" 
2) "hello, peter" 


redis> SMEMBERS my_songs 
1) "good bye joe" 
2) "falling" 


redis> SINTERSTORE song_interset songs my_songs 
(integer) 1 


redis> SMEMBERS song_interset 
1) "good bye joe" 


SISMEMBER 


SISMEMBER key member 

判断 member 元 素 是 否 集合 key 的 成 员 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 


如 果 member 元 素 是 集合 的 成 员 ， 返 回 1 o WR member 
AE, REl o 。 


redis> SMEMBERS joe's_movies 


1) "hi, lady" 
2) "Fast Five" 
3) "2012" 


redis> SISMEMBER joe's_movies "bet man" 
(integer) 0 


redis> SISMEMBER joe's_movies "Fast Five" 
(integer) 1 


元 素 不 是 集合 的 成 员 ， 或 key 


SMEMBERS 


SMEMBERS key 

返回 集合 key 中 的 所 有 成 员 。 
不 存在 的 key 被 视 为 空 集合 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N) n 为 集合 的 基数 。 


返回 值 : 
集合 中 的 所 有 成 员 。 


# key 不 存在 或 集合 为 空 


redis> EXISTS not_exists_key 
(integer) 0 


redis> SMEMBERS not_exists_key 
(empty list or set) 


# 非 空 集合 


redis> SADD language Ruby Python Clojure 
(integer) 3 


redis> SMEMBERS language 
1) "Python" 

2) "Ruby" 

3) "Clojure" 


SMOVE 


SMOVE source destination member 
将 member 元 素 从 source 集合 移动 到 destination 集合 。 
SMOVE 是 原子 性 操作 。 


如 果 source 集合 不 存在 或 不 包含 指定 的 member 元 素 ， 则 SMOVE 命令 不 执行 任何 操作 ， 
仅 返 回 o > EN], member 元 素 从 source 集合 中 被 移 除 ， 并 添加 到 destination 集合 中 
去 。 


destination 集合 已 经 包含 member 元 素 时 ， SMOVE 命令 只 是 简单 地 将 source 集合 中‏ كلا 
的 member 元 素 删 除 。‏ 


当 source 或 destination 不 是 集合 类 型 时 ， 返 回 一 个 错误 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 


如 果 member 元 素 被 成 功 移 除 ， 返 回 1 o WR member 元 素 不 是 source 集合 的 成 员 ， 并 
且 没 有 任何 操作 对 destination 集合 执行 ， 那么 返回 o 。 


redis> SMEMBERS songs 
1) "Billie Jean" 
2) "Believe Me" 


redis> SMEMBERS my_songs 
(empty list or set) 


redis> SMOVE songs my_songs "Believe Me" 
(integer) 1 


redis> SMEMBERS songs 
1) "Billie Jean" 


redis> SMEMBERS my_songs 
1) "Believe Me" 


SPOP 


SPOP key 
移 除 并 返回 集合 中 的 一 个 随机 元 素 。 


如 果 只 想 获取 一 个 随机 元 素 ， 但 不 想 该 元 素 从 集合 中 被 移 除 的 话 ， 可 以 使 用 
SRANDMEMBER È. 


可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

被 移 除 的 随机 元 素 。 当 key 不 存在 或 key 是 空 集 时 ， 返 回 nil 。 


redis> SMEMBERS db 


1 ) 1 MySQL W 
2) "MongoDB" 
3) "Redis" 


redis> SPOP db 
"Redis" 


redis> SMEMBERS db 
1 ) 1 MySQL " 
2) "MongoDB" 


redis> SPOP db 
mW MySQL W 


redis> SMEMBERS db 
1) "MongoDB" 


SRANDMEMBER 


SRANDMEMBER key [count] 
如 果 命 令 执 行 时 ， 只 提供 了 key 参数， 那么 返回 集合 中 的 一 个 随机 元 素 。 
从 Redis 2.6 版 本 开始 ， SRANDMEMBER 命令 接受 可 选 的 count BR: 


٠ 如 果 count 为 正 数 ， 且 小 于 集合 基数 ， 那 么 命令 返回 一 个 包含 count 个 元 素 的 数组 ， 
数组 中 的 元 素 各 不 相同 。 如 果 count 大 于 等 于 集合 基数 ， 那 么 返回 整个 集合 。 

٠ 如 果 cont 为 负数 ， 那 么 命令 返回 一 个 数组 ， 数 组 中 的 元 素 可 能 会 重复 出 现 多 次 ， 而 数 
组 的 长 度 为 ”count 的 绝对 值 。 


该 操作 和 SPOP 相似 ， 但 SPOP 将 随机 元 素 从 集合 中 移 除 并 返回 ， 而 SRANDMEMBER 则 
仅仅 返回 随机 元 素 ， 而 不 对 集合 进行 任何 改动 。 


可 用 版 本 : 
>= 1.0.0 
时 间 复 条 度 : 


只 提供 key 参数 时 为 O(1) 。 如 果 提 供 了 count 参数， 那么 为 ON), N 为 返回 数组 的 元 素 
个 数 。 


返回 值 : 


只 提供 key 参数 时 ， 返 回 一 个 元 素 ; 如 果 集 合 为 空 ， 返 回 nil 。 如 果 提 供 了 cout 参 
数 ， 那 么 返回 一 个 数组 ; 如 果 集 合 为 空 ， 返 回 空 数组 。 


# 添加 元 素 


redis> SADD fruit apple banana cherry 
(integer) 3 


# RAE key 参数 ， 返 回 一 个 随机 元 素 


redis> SRANDMEMBER fruit 
"cherry" 


redis> SRANDMEMBER fruit 
"apple" 


# 给 定 3 为 count 参数 ， 返 回 3 个 随机 元 素 
# 每 个 随机 元 素 都 不 相同 


redis> SRANDMEMBER fruit 3 


1) "apple" 
2) "banana" 
3) "cherry" 


# 给 定 -3 为 count 参数 ， 返 回 3 个 随机 元 素 
# 元 素 可 能 会 重复 出 现 多 次 


redis> SRANDMEMBER fruit -3 
1) "banana" 


2) "cherry" 

3) "apple" 

redis> SRANDMEMBER fruit -3 
1) "apple" 

2) "apple" 

3) "cherry" 


# 如 果 count 是 整数 ， 且 大 于 等 于 集合 基数 ， 那 么 返回 整个 集合 


redis> SRANDMEMBER fruit 10 


1) "apple" 
2) "banana" 
3) "cherry" 


# 如 果 count 是 负数 ， 且 count 的 绝对 值 大 于 集合 的 基数 
# 那么 返回 的 数组 的 长 度 为 count 的 绝对 值 


redis> SRANDMEMBER fruit -10 
1) "banana" 


2) "apple" 
3) "banana" 
4) "cherry" 
5) "apple" 
6) "apple" 
7) "cherry" 
8) "apple" 
9) "apple" 


10) "banana" 

# SRANDMEMBER 并 不 会 修改 集合 内 容 
redis> SMEMBERS fruit 

1) "apple" 


2) "cherry" 
3) "banana" 


# 集合 为 空 时 返回 nil 或 者 空 数组 


redis> SRANDMEMBER not-exists 
(nil) 


redis> SRANDMEMBER not-eixsts 10 
(empty list or set) 
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SREM 


SREM key member [member ...] 

移 除 集合 key 中 的 一 个 或 多 个 member 元 素 ， 不 存在 的 member 
当 key 不 是 集合 类 型 ， 返 回 一 个 错误 。 

Note 

在 Redis 2.4 版 本 以 前 ， SREM 只 接受 单个 member 值 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N), N 为 给 定 member 元 素 的 数量 。 

返回 值 : 

被 成 功 移 除 的 元 素 的 数量 ， 不 包括 被 忽略 的 元 素 。 


# 测试 数据 

redis> SMEMBERS languages 
1) Welt 

2) "lisp" 

3) "python" 

4) "ruby" 


# 移 除 单个 元 素 


redis> SREM languages ruby 
(integer) 1 


# 移 除 不 存在 元 素 


redis> SREM languages non-exists-language 
(integer) 0 


# 移 除 多 个 元 素 


redis> SREM languages lisp python c 
(integer) 3 


redis> SMEMBERS languages 
(empty list or set) 


SUNION 


SUNION key [key …] 

返回 一 个 集合 的 全 部 成 员 ， 该 集合 是 所 有 给 定 集合 的 并 集 。 
不 存在 的 key 被 视 为 空 集 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N) n 是 所 有 给 定 集合 的 成 员 数 量 之 和 。 

返回 值 : 

并 集成 员 的 列表 。 


redis> SMEMBERS songs 
1) "Billie Jean" 


redis> SMEMBERS my_songs 
1) "Believe Me" 


redis> SUNION songs my_songs 
1) "Billie Jean" 
2) "Believe Me" 


SUNIONSTORE 


SUNIONSTORE destination key [key ...] 


这 个 命令 类 似 于 SUNION ÈS, 但 它 将 结果 保存 到 destination 集合 ， 而 不 是 简单 地 返回 结 
果 集 。 


如 果 destination 已 经 存在 ， 则 将 其 覆盖 。 
destination 可 以 是 key 本 身 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N), AN 是 所 有 给 定 集合 的 成 员 数 量 之 和 。 
返回 值 : 

结果 集中 的 元 素数 量 。 


redis> SMEMBERS NoSQL 
1) "MongoDB" 

2) "Redis" 

redis> SMEMBERS SQL 
1) "sqlite" 

2) "MySQL" 


redis> SUNIONSTORE db NoSQL SQL 
(integer) 4 


redis> SMEMBERS db 


1) "MySQL" 
2) "sqlite" 
3) "MongoDB" 


4) "Redis" 


SSCAN 


SSCAN key cursor [MATCH pattern] [COUNT count] 


详细 信息 请 参考 SCAN 命令 。 


SortedSet (有 序 集 合 ) 


ZADD 


ZADD key score member [[score member] [score member] ...] 
将 一 个 或 多 个 member 元 素 及 其 score 值 加 入 到 有 序 集 key 4H. 


如 果 某 个 member 已 经 是 有 序 集 的 成 员 ， 那 么 更 新 这 个 member 的 score 值 ， 并 通过 重新 
插入 这 个 member 元 素 ， 来 保证 该 member 在 正确 的 位 置 上 。 


score 值 可 以 是 整数 值 或 双 精 度 浮 点 数 。 

如 果 key 不 存在 ， 则 创建 一 个 空 的 有 序 集 并 执行 ZADD 操作 。 

4 key 存在 但 不 是 有 序 集 类 型 时 ， 返 回 一 个 错误 。 

对 有 序 集 的 更 多 介绍 请 参见 sorted set 。 

Note 

在 Redis 2.4 版 本 以 前 ，ZADD 每 次 只 能 添加 一 个 元 素 。 

可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

O(M*log(N)), n 是 有 序 集 的 基数 ， Mm 为 成 功 添加 的 新 成 员 的 数量 。 
返回 值 : 

被 成 功 添加 的 新 成 员 的 数量 ， 不 包括 那些 被 更 新 的 、 已 经 存在 的 成 员 。 


# 添加 单个 元 素 


redis> ZADD page_rank 10 google.com 
(integer) 1 


# 添加 多 个 元 素 


redis> ZADD page_rank 9 baidu.com 8 bing.com 
(integer) 2 


redis> ZRANGE page_rank © -1 WITHSCORES 
1) "bing.com" 


2) uan 

3) "baidu.com" 
4) mon 

5) "google.com" 
6) "10" 


# 添加 已 存在 元 素 ， 且 score 值 不 变 


redis> ZADD page_rank 10 google.com 
(integer) 0 


redis> ZRANGE page_rank © -1 WITHSCORES # 没有 改变 
1) "bing.com" 


2) we 

3) "baidu.com" 
4) How 

5) "google.com" 
6) "46" 


# 添加 已 存在 元 素 ， 但 是 改变 score fh 


redis> ZADD page_rank 6 bing.com 
(integer) 0 


redis> ZRANGE page_rank © -1 WITHSCORES # bing.com 元 素 的 score 值 被 改变 
1) "bing.com" 


2) m6" 
3) "baidu.com" 
4) "gt 


5) "google.com" 
6) "469" 


ZCARD 


ZCARD key 

返回 有 序 集 key 的 基数 。 

可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

4 ky 存在 且 是 有 序 集 类 型 时 ， 返 回 有 序 集 的 基数 。 当 key 不 存在 时 ， 


redis > ZADD salary 2000 tom # 添加 一 个 成 员 
(integer) 1 


redis > ZCARD Salary 
(integer) 1 


redis > ZADD salary 5000 jack # 再 添加 一 个 成 员 
(integer) 1 


redis > ZCARD salary 
(integer) 2 


redis > EXISTS non_exists_key # 对 不 存在 的 key 进行 ZCARD 操作 
(integer) 0 


redis > ZCARD non_exists_key 
(integer) 0 


5 


0 


o 


ZCOUNT 


ZCOUNT key min max 


WEARS key 中 ， score (AE min 和 max 之 间 ( 默 认 包括 score ASF min 或 
max ) 的 成 员 的 数量 。 


关于 参数 min 和 max 的 详细 使 用 方法 ， 请 参考 ZRANGEBYSCORE 命令 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(log(N)), n 为 有 序 集 的 基数 。 

返回 值 : 

score 值 在 min 和 max 之 间 的 成 员 的 数量 。 


redis> ZRANGE salary 0 -1 WITHSCORES # 测试 数据 


1) "jack" 

2) "2000" 

3) "peter" 

4) "3500" 

5) "tom" 

6) "5000" 

redis> ZCOUNT salary 2000 5000 # 计算 薪水 在 2000-5000 之 间 的 人 数 


(integer) 3 


redis> ZCOUNT salary 3000 0 # 计算 薪水 在 3000-5000 之 间 的 人 数 
(integer) 2 


ZINCRBY 


ZINCRBY key increment member 
为 有 序 集 key 的 成 员 member 的 score 值 加 上 增 量 increment o 


可 以 通过 传递 一 个 负数 值 increment , ik score 减 去 相应 的 值 ， 上 比如 


ZINCRBY key -5 member ， 就 是 让 member 的 score 值 减 去 5 。 


当 key 不 存在 ， 或 member 不 是 key 的 成 员 时 ， ZINCRBY key increment member 等 同 于 


ZADD key increment member 。 

4 ky 不 是 有 序 集 类 型 时 ， 返 回 一 个 错误 。 
score 值 可 以 是 整数 值 或 双 精 度 浮 点 数 。 

可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

O(log(N)) 

返回 值 : 

member 成 员 的 新 score 值 ， 以 字符 串 形 式 表 示 。 


redis> ZSCORE salary tom 
"2000" 


redis> ZINCRBY salary 2000 tom # tom 加 薪 啦 ! 
"4000" 


ZRANGE 


ZRANGE key start stop [WITHSCORES] 

返回 有 序 集 key 中 ， 指 定 区 间 内 的 成 员 。 

其 中 成 员 的 位 置 按 score 值 递增 (从 小 到 大 ) 来 排序 。 

具有 相同 score 值 的 成 员 按 字典 序 (lexicographical order ) 来 排列 。 

如 果 你 需要 成 员 按 score 值 递减 (从 大 到 小 ) 来 排列 ， 请 使 用 ZREVRANGE ARo 


下 标 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 o0 表示 有 序 集 第 一 个 成 员 , 以 1 
表示 有 序 集 第 二 个 成 员 ， 以 此 类 推 。 你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 最 后 一 个 成 员 ， 
-2 表示 倒数 第 二 个 成 员 ， 以 此 类 推 。 超 出 范围 的 下 标 并 不 会 引起 错误 。 比 如 说 ， 当 start 
的 值 比 有 序 集 的 最 大 下 标 还 要 大 ， 或 是 start > stop 时 ， ZRANGE 命令 只 是 简单 地 返回 一 
个 空 列表 。 另 一 方面 ， 假 如 stop 参数 的 值 比 有 序 集 的 最 大 下 标 还 要 大 ， 那 么 Redis 将 
stop 当 作 最 大 下 标 来 处 理 。 可 以 通过 使 用 wITHSCORES 选项 ， 来 让 成 员 和 它 的 score 值 一 


并 返回 ， 返回 列表 以 value1,score1, ..., valueN,scoreNn 的 格式 表示 。 客户 端 库 可 能 会 返回 
一 些 更 复杂 的 数据 类 型 ， 比 如 数组 、 元 组 等 。 

可 用 版 本 : 

>= 1.2.0 


时 间 复 条 度 : 

O(log(N)+M), n 为 有 序 集 的 基数 ， 而 Mm 为 结果 集 的 基数 。 
返回 值 : 

指定 区 间 内 ， 带 有 score 人 和 值 (可 选 ) 的 有 序 集 成 员 的 列表 。 


redis > ZRANGE 


1) "jack" 

2) "3500" 

3) "tom" 

4) "5000" 

5) "boss" 

6) "10086" 
redis > ZRANGE 
1) "tom" 

2) "5000" 

3) "boss" 

4) "10086" 
redis > ZRANGE 
1) "jack" 

2) "3500" 

3) "tom" 

4) "5000" 

5) "boss" 

6) "10086" 


redis > ZRANGE 
(empty list or 


salary 0 -1 WITHSCORES 


salary 1 2 WITHSCORES 


salary 0 200000 WITHSCORES 


salary 200000 3000000 WITHSCORES 
set) 


# 显示 整个 有 序 集 成 员 


# 显示 有 序 集 下 标 区 间 1 至 2 的 成 员 


# 测试 end 下 标 超 出 最 大 下 标 时 的 情况 


# 测试 当 给 定 区 间 不 存在 于 有 序 集 时 的 情况 


ZRANGEBYSCORE 


ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count] 


返回 有 序 集 key H, PRA score 值 介 于 min 和 max 之 间 ( 包 括 等 于 min 或 max ) 的 成 
员 。 有 序 集 成 员 按 score 值 递增 (从 小 到 大 ) 次 序 排列 。 


具有 相同 score 值 的 成 员 按 字典 序 (lexicographical order) 来 排列 (该 属性 是 有 序 集 提供 的 ， 不 
需要 额外 的 计算 )。 


可 选 的 LIMIT 参数 指定 返回 结果 的 数量 及 区 间 ( 就 像 SQL 中 的 SELECT LIMIT offset, count 
)， 注 意 当 offset 很 大 时 ， 定 位 offset 的 操作 可 能 需要 通 万 整个 有 序 集 ， 此 过 程 最 坏 复 条 
度 为 O(N) 时 间 。 


可 选 的 wITHSCORES 参数 决定 结果 集 是 单单 返回 有 序 集 的 成 员 ， 还 是 将 有 序 集成 员 及 其 
score 值 一 起 返回 。 该 选项 自 Redis 2.0 版 本 起 可 用 。 


区 间 及 无 限 


min 和 max 可 以 是 -inf 和 +inf , 这 样 一 来 ， 你 就 可 以 在 不 知道 有 序 集 的 最 低 和 最 高 
score 值 的 情况 下 ， 使 用 ZRANGEBYSCORE 这 类 命令 。 


默认 情况 下 ， 区 间 的 取 值 使 用 闭 区 间 (小 于 等 于 或 大 于 等 于 )， 你 也 可 以 通过 给 参数 前 增加 ( 
符号 来 使 用 可 选 的 开 区 间 (小 于 或 大 于 )。 


举 个 例子 : 


ZRANGEBYSCORE zset (1 5 


返回 所 有 符合 条 件 1 &lt; score &lt;= 5 的 成 员 ， 而 


ZRANGEBYSCORE zset (5 (10 


则 返回 所 有 符合 条 件 5 alt; score alt; 10 的 成 员 。 

可 用 版 本 : 

>= 1.0.5 

时 间 复 条 度 : 

O(log(N)+M), n 为 有 序 集 的 基数 ， Mm 为 被 结果 集 的 基数 。 
返回 值 : 


指定 区 间 内 ， 带 有 score 值 (可 选 ) 的 有 序 集 成 员 的 列表 。 


redis> ZADD salary 2500 jack # 测试 数据 

(integer) 0 

redis> ZADD salary 5000 tom 

(integer) 0 

redis> ZADD salary 12000 peter 

(integer) 0 

redis> ZRANGEBYSCORE salary -inf +inf # 显示 整个 有 序 集 

1) "jack" 

2) "tom" 

3) "peter" 

redis> ZRANGEBYSCORE salary -inf +inf WITHSCORES # 显示 整个 有 序 集 及 成 员 的 score 值 
1) "jack" 

2) "2500" 

3) "tom" 

4) "5000" 

5) "peter" 

6) "12000" 

redis> ZRANGEBYSCORE salary -inf 5000 WITHSCORES # 显示 工资 <=5000 的 所 有 成 员 
1) "jack" 

2) "2500" 

3) "tom" 

4) "5000" 

redis> ZRANGEBYSCORE salary (5000 400000 # 显示 工资 大 于 5000 小 于 等 于 400000 的 成 5 
1) "peter" 





站 Eee 


ZRANK 


ZRANK key member 


返回 有 序 集 key 中 成 员 member 的 排名 。 其 中 有 序 集成 员 按 score 值 递 增 (从 小 到 大 ) 顺 序 
排列 。 


排名 以 o 为 底 ， 也 就 是 说 ， score 值 最 小 的 成 员 排 名 为 6 。 

使 用 ZREVRANK 命令 可 以 获得 成 员 按 score 值 递 减 (从 大 到 小 ) 排 列 的 排名 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(log(N)) 

返回 值 : 


如 果 member 是 有 序 集 key 的 成 员 ， 返 回 member 的 排名 。 如 果 member REARS key 
的 成 员 ， 返 回 nil o 


redis> ZRANGE salary 0 -1 WITHSCORES # 显示 所 有 成 员 及 其 score 值 
1) "peter" 

2) "3500" 

3) "tom" 

4) "4000" 

5) "jack" 

6) "5000" 

redis> ZRANK salary tom # 显示 tom 的 薪水 排名 ， 第 二 


(integer) 1 


ZREM 


ZREM key member [member ...] 

移 除 有 序 集 key 中 的 一 个 或 多 个 成 员 ， 不 存在 的 成 员 将 被 忽略 。 
4 ky 存在 但 不 是 有 序 集 类 型 时 ， 返 回 一 个 错误 。 

Note 

在 Redis 2.4 版 本 以 前 ，ZREM 每 次 只 能 删除 一 个 元 素 。 

可 用 版 本 : 

>= 1.2.0 

时 间 复杂 度 : 

O(M*log(N)), n 为 有 序 集 的 基数 ， Mm 为 被 成 功 移 除 的 成 员 的 数量 。 
返回 值 : 

被 成 功 移 除 的 成 员 的 数量 ， 不 包括 被 忽略 的 成 员 。 


# 测试 数据 


redis> ZRANGE page_rank 0 -1 WITHSCORES 
1) "bing.com" 


2) Wey 

3) "baidu.com" 
4) nogu 

5) "google.com" 
6) "46" 


# 移 除 单个 元 素 


redis> ZREM page_rank google.com 
(integer) 1 


redis> ZRANGE page_rank © -1 WITHSCORES 
1) "bing.com" 


2) "gu 
3) "baidu.com" 
4) nogu 


# 移 除 多 个 元 素 


redis> ZREM page_rank baidu.com bing.com 
(integer) 2 


redis> ZRANGE page_rank © -1 WITHSCORES 
(empty list or set) 


# 移 除 不 存在 元 素 


redis> ZREM page_rank non-exists-element 
(integer) 0 
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ZREMRANGEBYRANK 


ZREMRANGEBYRANK key start stop 
移 除 有 序 集 key 中 ， 指 定 排名 (rank) 区 间 内 的 所 有 成 员 。 
区 间 分 别 以 下 标 参 数 start 和 stop WH, BS start 和 stop 在 内 。 


下 标 参 数 start 和 stop 都 以 o 为 底 ， 也 就 是 说 ， 以 و‎ 表示 有 序 集 第 一 个 成 员 ， 以 
表示 有 序 集 第 二 个 成 员 ， 以 此 类 推 。 你 也 可 以 使 用 负数 下 标 ， 以 -1 表示 最 后 一 个 成 员 ， 
-2 表示 倒数 第 二 个 成 员 ， 以 此 类 推 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(log(N)+M), n 为 有 序 集 的 基数 ， 而 Mm 为 被 移 除 成 员 的 数量 。 


返回 值 : 
被 移 除 成 员 的 数量 。 


redis> ZADD salary 2000 jack 
(integer) 1 

redis> ZADD salary 5000 tom 
(integer) 1 

redis> ZADD salary 3500 peter 
(integer) 1 


redis> ZREMRANGEBYRANK salary 0 1 # 移 除 下 标 0 至 1 区 间 内 的 成 员 
(integer) 2 


redis> ZRANGE salary © -1 WITHSCORES # 有 序 集 只 剩 下 一 个 成 员 
1) "tom" 
2) "5000" 


ZREMRANGEBYSCORE 


ZREMRANGEBYSCORE key min max 


移 除 有 序 集 key 中 ， 所 有 score (ATF min 和 max 之 间 ( 包 括 等 于 min 或 max ) 的 成 


o 


كر 


自 版 本 2.1.6 开 始 ， score (ASF min 或 max 的 成 员 也 可 以 不 包括 在 内 ， 详 情 请 参见 
ZRANGEBYSCORE @ S. 


可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

O(log(N)+M), n 为 有 序 集 的 基数 ， 而 m 为 被 移 除 成 员 的 数量 。 
返回 值 : 

被 移 除 成 员 的 数量 。 


redis> ZRANGE salary © -1 WITHSCORES # 显示 有 序 集 内 所 有 成 员 及 其 score fa 
1) "tom" 

2) "2000" 

3) "peter" 

4) "3500" 

5) "jack" 

6) "5000" 

redis> ZREMRANGEBYSCORE salary 1500 3500 # 移 除 所 有 薪水 在 1500 到 3500 内 的 员工 
(integer) 2 

redis> ZRANGE salary © -1 WITHSCORES # 剩 下 的 有 序 集成 员 

1) "jack" 


2) "5000" 


ZREVRANGE 


ZREVRANGE key start stop [WITHSCORES] 
返回 有 序 集 key 中 ， 指定 区 间 内 的 成 员 o 


其 中 成 员 的 位 置 按 score 值 递 减 (从 大 到 小 ) 来 排列 。 具 有 相同 score 值 的 成 员 按 字典 序 的 
XF (reverse lexicographical order) 排 列 。 


除了 成 员 按 score 值 递减 的 次 序 排列 这 一 点 外 ， ZREVRANGE 命令 的 其 他 方面 和 ZRANGE 


命令 一 样 。 

可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

O(log(N)+M), n 为 有 序 集 的 基数 ， 而 m 为 结果 集 的 基数 。 
返回 值 : 

指定 区 间 内 ， 带 有 score 值 (可 选 ) 的 有 序 集成 员 的 列表 。 


redis> ZRANGE salary © -1 WITHSCORES # 递增 排列 
1) "peter" 

2) "3500" 

3) "tom" 

4) "4000" 

5) "jack" 

6) "5000" 


redis> ZREVRANGE salary © -1 WITHSCORES # 递减 排列 
1) "jack" 

2) "5000" 

3) "tom" 

4) "4000" 

5) "peter" 

6) "3500" 


ZREVRANGEBYSCORE 


ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count] 


WEARS key H, score 值 介 于 max 和 min 之 间 ( 默 认 包括 等 于 max 或 min ) 的 所 
有 的 成 员 。 有 序 集成 员 按 score 值 递减 (从 大 到 小 ) 的 次 序 排列 。 


具有 相同 score 值 的 成 员 按 字典 序 的 逆序 (reverse lexicographical order ) 排 列 。 


除了 成 员 按 score 值 递减 的 次 序 排列 这 一 点 外 ， ZREVRANGEBYSCORE 命令 的 其 他 方面 
和 ZRANGEBYSCORE 命令 一 样 。 


可 用 版 本 : 

>= 2.2.0 

时 间 复 条 度 : 

O(log(N)+M), n 为 有 序 集 的 基数 ， Mm 为 结果 集 的 基数 。 
返回 值 : 

指定 区 间 内 ， 带 有 score 值 (可 选 ) 的 有 序 集成 员 的 列表 。 


redis > ZADD salary 10086 jack 
(integer) 1 

redis > ZADD salary 5000 tom 
(integer) 1 

redis > ZADD salary 7500 peter 
(integer) 1 

redis > ZADD salary 3500 joe 
(integer) 1 


redis > ZREVRANGEBYSCORE salary +inf -inf # 道 序 排列 所 有 成 员 


1) "jack" 

2) "peter" 

3) "tom" 

4) "joe" 

redis > ZREVRANGEBYSCORE salary 10000 2000 # 逆序 排列 薪水 介 于 10000 和 2000 之 间 的 成 员 
1) "peter" 

2) "tom" 


3) "joe" 


ZREVRANK 


ZREVRANK key member 


返回 有 序 集 key 中 成 员 member 的 排名 。 其 中 有 序 集成 员 按 score 值 递减 (从 大 到 小 ) 排 


序 。 
排名 以 。 为 底 ， 也 就 是 说 ， 


使 用 ZRANK 命令 可 以 获得 成 员 按 score 值 递 增 (从 小 到 大 ) 排 列 的 排名 。 


可 用 版 本 : 
>= 2.0.0 
时 间 复 条 度 : 
O(log(N)) 


返回 值 : 


如 果 member 是 有 序 集 key 的 成 员 ， 返 回 member 的 排名 。 如 果 member REARS 


的 成 员 ， 返 回 nil o 


score 值 最 大 的 成 员 排名 为 © 。 


redis 127.0.0.1:6379> ZRANGE salary © -1 WITHSCORES 


1) "jack" 
2) "2000" 
3) "peter" 
4) "3500" 
5) "tom" 

6) "5000" 


redis> ZREVRANK salary peter 
(integer) 1 


redis> ZREVRANK salary tom 
(integer) 0 


# peter 的 工资 排 第 二 


# tom 的 工资 最 高 


key 


ZSCORE 


ZSCORE key member 

返回 有 序 集 key 中 ， 成 员 member 的 score 值 。 

如 果 member 元 素 不 是 有 序 集 key 的 成 员 ， 或 key 不 存在 ， 返 回 nil o 
可 用 版 本 : 

>= 1.2.0 


时 间 复 条 度 : 


member 成 员 的 score 值 ， 以 字符 串 形 式 表 示 。 


redis> ZRANGE salary © -1 WITHSCORES # 测试 数据 


1) "tom" 

2) "2000" 

3) "peter" 

4) "3500" 

5) "jack" 

6) "5000" 

redis> ZSCORE salary peter # 注意 返回 值 是 字符 串 


"3500" 


ZUNIONSTORE 


ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...[[ 
[AGGREGATE SUM|MIN|MAX] 


计算 给 定 的 一 个 或 多 个 有 序 集 的 并 集 ， 其 中 给 定 key 的 数量 必须 以 numkeys 参数 指定 ， 并 
将 该 并 集 (结果 集 ) 储 存 到 destination o 


默认 情况 下 ， 结 果 集 中 某 个 成 员 的 score 值 是 所 有 给 定 集 下 该 成 员 score 值 之 和 。 
WEIGHTS 


使 用 wEIGHTS 选项 ， 你 可 以 为 每 个 给 定 有 序 集 分 别 指定 一 个 乘法 因子 (multiplication 
factor)， 每 个 给 定 有 序 集 的 所 有 成 员 的 score 值 在 传递 给 聚合 辑 数 (aggregation function) 之 
前 都 要 先 乘 以 该 有 序 集 的 因子 。 


如 果 没 有 指定 _wEiGHTS 选项 ， 乘 法 因子 默认 设置 为 1 。 
AGGREGATE 
使 用 AGGREGATE 选项 ， 你 可 以 指定 并 集 的 结果 集 的 聚合 方式 。 


默认 使 用 的 参数 sum ， 可 以 将 所 有 集合 中 某 个 成 员 的 score 值 之 和 作为 结果 集中 该 成 员 
BY score fi; 使 用 参数 mn ， 可 以 将 所 有 集合 中 某 个 成 员 的 最 小 score 值 作为 结果 集中 
该 成 员 的 score 值 ; 而 参数 max 则 是 将 所 有 集合 中 某 个 成 员 的 RA score 值 作为 结果 集 
中 该 成 员 的 score 值 。 


可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(N)+O(M log(M)), n 为 给 定 有 序 集 基 数 的 总 和 ， M 为 结果 集 的 基数 。 
返回 值 : 

保存 到 destination 的 结果 集 的 基数 。 


redis> ZRANGE programmer © -1 WITHSCORES 


1) "peter" 
2) "2000" 
3) "jack" 
4) "3500" 
5) "tom" 
6) "5000" 
redis> ZRANGE manager 0 -1 WITHSCORES 
1) "herry" 
2) "2000" 
3) "mary" 
4) "3500" 
5) "bob" 
6) "4000" 


redis> ZUNIONSTORE salary 2 programmer manager WEIGHTS 1 3 # 公司 决定 加 薪 。。。 除 了 程序 员 。。 
(integer) 6 


redis> ZRANGE salary 0 -1 WITHSCORES 


1) "peter" 
2) "2000" 
3) "jack" 
4) "3500" 
5) "tom" 
6) "5000" 
7) "herry" 
8) "6000" 
9) "mary" 
10) "10500" 
11) "bob" 


12) "12000" 





ZINTERSTORE 


ZINTERSTORE destination numkeys key [key ...[ [WEIGHTS weight [weight ...[[ 
[AGGREGATE SUM|MIN|MAX] 


计算 给 定 的 一 个 或 多 个 有 序 集 的 交集 ， 其 中 给 定 key 的 数量 必须 以 numkeys 参数 指定 ， 并 
将 该 交集 (结果 集 ) 储 存 到 destination o 


默认 情况 下 ， 结 果 集 中 某 个 成 员 的 score 值 是 所 有 给 定 集 下 该 成 员 score 值 之 和 |. 
关于 weIGHTS 和 AGGREGATE 选项 的 描述 ， 参 见 ZUNIONSTOARE AD. 

可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 


O(NK)+O(Mlog(M)), n 为 给 定 ky 中 基数 最 小 的 有 序 集 ， k 为 给 定 有 序 集 的 数量 ， m 
为 结果 集 的 基数 。 


返回 值 : 
保存 到 destination 的 结果 集 的 基数 。 


redis > ZADD mid test 70 "Li Lei" 
(integer) 1 

redis > ZADD mid_test 70 "Han Meimei" 
(integer) 1 

redis > ZADD mid_test 99.5 "Tom" 
(integer) 1 


redis > ZADD fin_test 88 "Li Lei" 
(integer) 1 

redis > ZADD fin test 75 "Han Meimei" 
(integer) 1 

redis > ZADD fin_test 99.5 "Tom" 
(integer) 1 


redis > ZINTERSTORE sum_point 2 mid_test fin_test 
(integer) 3 


redis > ZRANGE sum_point 0 -1 WITHSCORES # 显示 有 序 集 内 所 有 成 员 及 其 score ff 
1) "Han Meimei" 

2) "145" 

3) "Li Lei" 

4) "158" 

5) "Tom" 


6) "499" 


ZSCAN 


ZSCAN key cursor [MATCH pattern] [COUNT count] 


详细 信息 请 参考 SCAN PF. 


Pub/Sub 发布 /订阅 ) 


PSUBSCRIBE 


PSUBSCRIBE pattern [pattern .…] 


订阅 一 个 或 多 个 符合 


每 个 模式 以 


و 


news .global.today 等 等 )， 


it.tweets 等 等 )， 


news. * 


给 定 模式 的 频道 。 


作为 匹配 符 ， 比 如 itt 匹配 所 有 以 it 开头 
匹配 所 有 以 news. 
诸如 此 类 。 


LAY IAI 
开头 的 频 道 ( news.it 、 


道 ( it.news 


可 用 版 本 : 


>= 2.0.0 


时 间 复 杂 度 : 


O(N), 


返回 值 : 


接收 到 的 信息 (请 参 


N 是 订阅 的 模式 的 数量 。 


# 订阅 news.* 和 tweet.* 两 个 模式 


# 第 1 - 6 行 是 执行 psubscribe 之 后 的 反 


a 


# 
# 
# 以 此 类 推 。。。 


a 


第 7 - 10 才 是 接收 到 的 第 一 条 信息 
第 11 - 14 是 第 二 条 


redis> psubscribe news.* tweet.* 
(press Ctrl-C to quit) 
# 返回 值 的 类 型 : 显示 订阅 成 功 
# 订阅 的 模式 


Reading messages... 


见 下 面 的 代码 说 明 )。 


反馈 信息 





1) "psubscribe" 

2) "news.*" 

3) (integer) 1 # 

1) "psubscribe" 

2) "tweet.*" 

3) (integer) 2 

1) "pmessage" # 返回 
2) "news. *" # 信息 
3) "news.it" # 信息 
4) "Google buy Motorola" # 信息 
1) "pmessage" 

2) "tweet.*" 

3) "tweet .huangz" 

4) "hello" 

1) "pmessage" 

2) "tweet.*" 

3) "tweet.joe" 

4) "@huangz morning" 

1) "pmessage" 

2) "news.*" 

3) "news.life" 

4) "An apple a day, keep doctors away" 


目前 已 订阅 的 模式 的 数量 





و 


it.blog 
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PUBLISH 


PUBLISH channel message 

将 信息 message 发 送 到 指定 的 频道 channel o 

可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(N+M)， 其 中 N 是 频道 channel 的 订阅 者 数量 ， 而 M 则 是 使 用 模式 订阅 (subscribed 
patterns) 的 客户 端的 数量 。 

返回 值 : 

接收 到 信息 message 的 订阅 者 数量 。 


# 对 没有 订阅 者 的 频道 发 送信 息 


redis> publish bad_channel "can any body hear me?" 
(integer) 0 


# 向 有 一 个 订阅 者 的 频道 发 送信 息 


redis> publish msg "good morning" 
(integer) 1 


# 向 有 多 个 订阅 者 的 频道 发 送信 息 


redis> publish chat_room "hello~ everyone" 
(integer) 3 


PUBSUB 


PUBSUB <subcommand> [argument [argument ...]] 


PUBSUB 是 一 个 查看 订阅 与 发 布 系统 状态 的 内 省 命令 ， 它 由 数 个 不 同 格式 的 子 命令 组 成 ， 
以 下 将 分 别 对 这 些 子 命令 进行 介绍 。 


可 用 版 本 : >= 2.8.0 


PUBSUB CHANNELS [pattern] 


列 出 当前 的 活路 频道 。 
活跃 频道 指 的 是 那些 至 少 有 一 个 订阅 者 的 频道 ， 订阅 模式 的 客户 端 不 计算 在 内 。 
pattern 参数 是 可 选 的 : 


٠ 如 果 不 给 出 pattern 参数 ， 那 么 列 出 订阅 与 发 布 系统 中 的 所 有 活跃 频道。 
٠ 如 果 给 出 pattern 参数 ， 那 么 只 列 出 和 给 定 模式 pattern 相 匹 配 的 那些 活路 频道 。 


复 条 度 : ON), n 为 活跃 频道 的 数量 (对 于 长 度 较 短 的 频道 和 模式 来 说 ， 将 进行 模式 匹配 
的 复杂 度 视 为 常数 ) 。 


返回 值 : 一 个 由 活跃 频道 组 成 的 列表 。 


# client-1 订阅 news.it 和 news.sport 两 个 频道 


client-1> SUBSCRIBE news.it news.sport 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) "news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.sport" 

3) (integer) 2 


# client-2 订阅 news.it 和 news.internet 两 个 频道 


client-2> SUBSCRIBE news.it news.internet 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) "news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.internet" 

3) (integer) 2 


# 首先 ， client-3 打印 所 有 活跃 频道 
# 注意 ， 即 使 一 个 频道 有 多 个 订阅 者 ， 它 也 只 输出 一 次 ， 比 如 news.it 


client-3> PUBSUB CHANNELS 
1) "news.sport" 

2) "news.internet" 

3) "news.it" 


# 接 下 来 ， client-3 打印 那些 与 模式 news.i* 相 匹 配 的 活路 频道 
# 因为 news.sport 不 匹配 news.i* ， 所 以 它 没有 被 打印 


redis> PUBSUB CHANNELS news.i* 


1) "news.internet" 
2) "news.it" 


PUBSUB NUMSUB [channel-1 ... channel-N] 


返回 给 定 频道 的 订阅 者 数量 ， 订阅 模式 的 客户 端 不 计算 在 内 。 
ZE: O(N), n 为 给 定 频道 的 数量 。 


返回 值 : 一 个 多 条 批量 回复 (Multi-bulk reply) ， 回 复 中 包含 给 定 的 频道 ， 以 及 频道 的 订阅 
者 数量 。 格式 为 : 频道 channel-1 ， channel-1 的 订阅 者 数量 ， 频 道 channel-2 و‎ 
channel-2 的 订阅 者 数量 ， 诸如 此 类 。 回复 中 频道 的 排列 顺序 和 执行 命令 时 给 定 频 道 的 排列 
顺序 一 致 。 不 给 定 任何 频道 而 直接 调用 这 个 命 命 也 是 可 以 的 ， 在 这 种 情况 下 ， 命令 只 返回 一 
个 空 列表 。 


# client-1 订阅 news.it 和 news.sport 两 个 频道 


client-1> SUBSCRIBE news.it news.sport 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) "news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.sport" 

3) (integer) 2 


# client-2 订阅 news.it 和 news.internet 两 个 频道 


client-2> SUBSCRIBE news.it news.internet 
Reading messages... (press Ctrl-C to quit) 
1) "subscribe" 

2) "news.it" 

3) (integer) 1 

1) "subscribe" 

2) "news.internet" 

3) (integer) 2 


# client-3 打印 各 个 频道 的 订阅 者 数量 


client-3> PUBSUB NUMSUB news.it 
1) "news.it" # 频道 


2( 12 # 订阅 该 频道 的 客户 端 数量 
3) "news.internet" 

4) ey Bun 

5) "news.sport" 

6) ey Bi 

7) "news.music" # 没有 任何 订阅 者 

8) Ng" 


PUBSUB NUMPAT 


返回 订阅 模式 的 数量 。 


注意 ， 这 个 命令 返回 的 不 是 订阅 模式 的 客户 端的 数量 ， 
和 。 


返回 值 : 一 个 整数 回复 (Integer reply) 。 


news.internet news.sport news.music 


而 是 客户 端 订阅 的 所 有 模式 的 数量 总 


# client-1 订阅 news.* 和 discount.* 两 个 模式 


client-1> PSUBSCRIBE news.* discount.* 
Reading messages... (press Ctrl-C to quit) 
1) "psubscribe" 

2) "news.*" 

3) (integer) 1 

1) "psubscribe" 

2) "discount.*" 

3) (integer) 2 


# client-2 订阅 tweet.* 一 个 模式 


client-2> PSUBSCRIBE tweet.* 


Reading messages... (press Ctrl-C to quit) 
1) "psubscribe" 
2) "tweet.*" 


3) (integer) 1 
# client-3 返回 当前 订阅 模式 的 数量 为 3 


client-3> PUBSUB NUMPAT 
(integer) 3 


# 注意 ， 当 有 多 个 客户 端 订 阅 相 同 的 模式 时 ， 相 同 的 订阅 也 被 计算 在 PUBSUB NUMPAT 之 内 
# 比如 说 ， 再 新 建 一 个 客户 端 client-4 ， 让 它 也 订阅 news.* 频道 





client-4> PSUBSCRIBE news. * 

Reading messages... (press Ctrl-C to quit) 
1) "psubscribe" 

2) "news.*" 

3) (integer) 1 





# 这 时 再 计算 被 订阅 模式 的 数量 ， 就 会 得 到 数量 为 4 


client-3> PUBSUB NUMPAT 
(integer) 4 


PUNSUBSCRIBE 


PUNSUBSCRIBE [pattern [pattern ...]] 
指示 客户 端 退 订 所 有 给 定 模式 。 


如 果 没 有 模式 被 指定 ， 也 即 是 ， 一 个 无 参数 的 puNsuBscRIBE 调用 被 执行 ， 那 么 客户 端 使 用 
PSUBSCRIBE 命令 订阅 的 所 有 模式 都 会 被 退 订 。 在 这 种 情况 下 ， 命 令 会 返回 一 个 信息 ， 告 知 
客户 端 所 有 被 退 订 的 模式 。 


可 用 版 本 : 
>= 2.0.0 
时 间 复 条 度 : 
O(N+M) ， 其 中 N 是 客户 端 已 订阅 的 模式 的 数量 ， Mm 则 是 系统 中 所 有 客户 端 订阅 的 模式 的 
数量 。 
返回 值 : 
这 个 命令 在 不 同 的 客户 端 中 有 不 同 的 表现 。 


SUBSCRIBE 


SUBSCRIBE channel [channel ...] 
订阅 给 定 的 一 个 或 多 个 频道 的 信息 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 条 度 : 

O(N)， 其 中 N 是 订阅 的 频道 的 数量 。 
返回 值 : 

接收 到 的 信息 (请 参见 下 面 的 代码 说 明 )。 


# 订阅 msg 和 chat_room 两 个 频道 


- 6 行 是 执行 subscribe 之 后 的 反馈 信息 
7 - 9 行 才 是 接收 到 的 第 一 条 信息 
第 10 - 12 行 是 第 二 条 


redis> subscribe msg chat_room 


Reading messages... (press Ctrl-C to quit) 
1) "subscribe" # 返回 值 的 类 型 : 显示 订阅 成 功 
2) "msg" # 订阅 的 频道 名 字 

3) (integer) 1 # 目前 已 订阅 的 频道 数量 


1) "subscribe" 
2) "chat_room" 
3) (integer) 2 


1) "message" # 返回 值 的 类 型 : 信息 
2) "msg" # 来 源 (从 那个 频道 发 送 过 来 ) 
3) "hello moto" # 信息 内 容 


1) "message" 
2) "chat_room" 
3) "testing...haha" 


UNSUBSCRIBE 


UNSUBSCRIBE [channel [channel ...]] 
指示 客户 端 退 订 给 定 的 频道 。 


如 果 没 有 频道 被 指定 ， 也 即 是 ， 一 个 无 参数 的 uNsuBscRIBE 调用 被 执行 ， 那 么 客户 端 使 用 
SUBSCRIBE 命令 订阅 的 所 有 频道 都 会 被 退 订 。 在 这 种 情况 下 ， 命 令 会 返回 一 个 信息 ， 告 知 
客户 端 所 有 被 退 订 的 频道 。 


可 用 版 本 : 
>= 2.0.0 
时 间 复 条 度 : 


O(N), n 是 客户 端 已 订阅 的 频道 的 数量 。 


jon 


这 个 命令 在 不 同 的 客户 端 中 有 不 同 的 表现 。 


Transaction (事务 ) 


DISCARD 


DISCARD 
取消 事务 ， 放 奔 执 行事 务 块 内 的 所 有 命令 。 


如 果 正 在 使 用 WATCH 命令 监视 某 个 (或 某 些 ) key， 那 么 取消 所 有 
UNWATCH 。 


可 用 版 本 : 


党 
SN 


是 返回 ok o 


redis> 


redis> 
QUEUED 


redis> 
OK 


MULTI 


PING 


SET greeting "hello" 


DISCARD 


Wk 
w 


视 ， 等 同 于 执行 命 命 


EXEC 


EXEC 
执行 所 有 事务 块 内 的 命令 。 


假如 某 个 (或 某 些 ) key 正 处 于 WATCH 命令 的 监视 之 下 ， 且 事务 块 中 有 和 这 个 (或 这 些 ) key 相 
KMT, ABA EXEC 命令 只 在 这 个 (或 这 些 ) key 没有 被 其 他 命令 所 改动 的 情况 下 执行 并 生 
效 ， 否 则 该 事务 被 打 断 (abort)。 


可 用 版 本 : 

>= 1.2.0 

时 间 复 条 度 : 

事务 块 内 所 有 命令 的 时 间 复 条 度 的 总 和 。 

返回 值 : 

事务 块 内 所 有 命令 的 返回 值 ， 按 命令 执行 的 先后 顺序 排列 。 当 操作 被 打 断 时 ， 返 回 空 值 nil 


o 


# 事务 被 成 功 执行 


redis> MULTI 
OK 


redis> INCR user_id 
QUEUED 


redis> INCR user_id 
QUEUED 


redis> INCR user_id 
QUEUED 


redis> PING 
QUEUED 


redis> EXEC 

1) (integer) 1 
2) (integer) 2 
3) (integer) 3 
4) PONG 


# 监视 key ， 且 事务 成 功 执行 


redis> WATCH lock lock_times 
OK 


redis> MULTI 
OK 


redis> SET lock "huangz" 
QUEUED 


redis> INCR lock_times 
QUEUED 


redis> EXEC 

1) OK 

2) (integer) 1 

# 监视 key ， 且 事务 被 打 断 


redis> WATCH lock lock_times 
OK 


redis> MULTI 


OK 

redis> SET lock "joe" # 就 在 这 时 ， 另 一 个 客户 端 修改 了 lock_times 的 值 
QUEUED 

redis> INCR lock_ times 

QUEUED 

redis> EXEC # 因为 lock_times 被 修改 ， joe 的 事务 执行 失败 


(nil) 


MULTI 


MULTI 
标记 一 个 事务 块 的 开始 。 


事务 块 内 的 多 条 命令 会 按照 先后 顺序 被 放 进 一 个 队列 当中 ， 最 后 由 EXEC 命令 原子 性 (atomic) 
地 执行 。 


可 用 版 本 : 
>= 1.2.0 


时 间 复 条 度 : 


redis> MULTI # 标记 事务 开始 
redis> INCR user_id # 多 条 命令 按 顺序 人 队 


redis> INCR user_id 
QUEUED 


redis> INCR user_id 
QUEUED 


redis> PING 
QUEUED 


redis> EXEC # 执行 
1) (integer) 1 

2) (integer) 2 

3) (integer) 3 

4) PONG 


UNWATCH 


UNWATCH 
取消 WATCH 命令 对 所 有 key 的 监视 。 


如 果 在 执行 WATCH ASLE, EXEC 命令 或 DISCARD 命令 先 被 执行 了 的 话 ， 那 么 就 不 需 
要 再 执行 UNWATCH 了 。 


因为 EXEC 命令 会 执行 事务 ， 因 此 WATCH 命令 的 效果 已 经 产生 了 ; 而 DISCARD 命令 在 取 
消 事务 的 同时 也 会 取消 所 有 对 key 的 监视 ， 因 此 这 两 个 命令 执行 之 后 ， 就 没有 必要 执行 
UNWATCH 了 。 


可 用 版 本 : 
>= 2.2.0 
THERE: 
O(1) 


返回 值 : 


K 


总 是 ok 。 


G 


redis> WATCH lock lock_times 
OK 


redis> UNWATCH 
OK 


WATCH 


WATCH key [key ...[ 


监视 一 个 (或 多 个 ) key ， 如 果 在 事务 执行 之 前 这 个 (或 这 些 ) key 被 其 他 命令 所 改动 ， 那 么 事务 
将 被 打 断 。 


可 用 版 本 : 
>= 2.2.0 


时 间 复 杂 度 : 


总 是 返回 ok 。 


redis> WATCH lock lock_times 
OK 


Script (脚本 ) 


EVAL 


EVAL script numkeys key [key ...] arg [arg ...] 


从 Redis 2.6.0 版 本 开始 ， 通 过 内 置 的 Lua 解释 器 ， 可 以 使 用 EVAL 命令 对 Lua 脚本 进行 求 
{Bo 


script 参数 是 一 段 Lua 5.1 脚本 程序 ， 它 会 被 运行 在 Redis 服务 器 上 下 文中 ， 这 段 脚本 不 必 
(也 不 应 该 ) 定 义 为 一 个 Lua HR, 


numkeys 参数 用 于 指定 键 名 参数 的 个 数 。 


键 名 参数 key [key ...[ M EVAL 的 第 三 个 参数 开始 算 起 ， 表 示 在 脚本 中 所 用 到 的 那些 
Redis 键 (key)， 这 些 键 名 参数 可 以 在 Lua 中 通过 全 局 变量 kEYs 数组 ， 用 1 为 基 址 的 形式 
访问 ( KEYS[1] ， KEYS[2] ， 以 此 类 推 )。 


在 命令 的 最 后 ， 那 些 不 是 键 名 参数 的 附加 参数 arg [arg ...] ， 可 以 在 Lua 中 通过 全 局 变量 
ARGV 数组 访问 ， 访 问 的 形式 和 keys 变量 类 似 ( ARGv[1] 、 ARGv[2] ， 诸 如 此 类 )。 


上 面 这 几 段 长 攻 的 说 明 可 以 用 一 个 简单 的 例子 来 概括 : 


> eval "return {KEYS[1],KEYS[2],ARGV[1],ARGV[2]}" 2 key1 key2 first second 
1) "key1" 

2) "key2" 

3( 105 

4) "second" 


其 中 "return {KEYS[1], KEYS[2], ARGV[1],ARGV[2]}" 是 被 求 值 的 Lua fA, AS 2 指定 了 键 
名 参数 的 数量 ， key1 和 key2 是 键 名 参数 ， 分 别 使 用 keYs[1] 和 kEYs[2] 访问 ， 而 最 后 
的 first 和 second 则 是 附加 参数 ， 可 以 通过 ARGv[1] 和 ARGv[2] 访问 它们 。 


在 Lua 脚本 中 ， 可 以 使 用 两 个 不 同 函 数 来 执行 Redis 命令 ， 它 们 分 别 是 : 


© redis.call() 


© redis.pcall() 


这 两 个 函数 的 唯一 区 别 在 于 它们 使 用 不 同 的 方式 外 理 执行 命令 所 产生 的 错误 ， 在 后 面 的 『 错 
RE] 部 分 会 讲 到 这 一 点 。 


redis.call() 和 redis.pcall() 两 个 图 数 的 参数 可 以 是 任何 格式 良好 (well formed) 的 Redis 


AA. 
fp : 


> eval "return redis.call('set', 'foo', 'bar')" 0 
OK 


需要 注意 的 是 ， 上 面 这 段 脚 本 的 确实 现 了 将 键 foo 的 值 设 为 bar 的 目的 ， 但 是 ， 它 违反 了 
EVAL 命令 的 语义 ， 因 为 脚本 里 使 用 的 所 有 键 都 应 该 由 KEYS 数组 来 传递 ， 就 像 这 样 : 


> eval "return redis.call('set',KEYS[1], 'bar')" 1 foo 
OK 


要 求 使 用 正确 的 形式 来 传递 键 (key) 是 有 原因 的 ， 因 为 不 仅仅 是 EVAL 这 个 命令 ， 所 有 的 
Redis 命令 ， 在 执行 之 前 都 会 被 分 析 ， 籍 此 来 确定 命令 会 对 哪些 键 进行 操作 。 


因此 ， 对 于 EVAL 命令 来 说 ， 必 须 使 用 正确 的 形式 来 传递 键 ， 才 能 确保 分 析 工 作 正 确 地 执 
行 。 除 此 之 外 ， 使 用 正确 的 形式 来 传递 键 还 有 很 多 其 他 好 处 ， 它 的 一 个 特别 重要 的 用 途 就 是 
确保 Redis 集群 可 以 将 你 的 请 求 发 送 到 正确 的 集群 节点 。( 对 Redis 集群 的 工作 还 在 进行 当 
中 ， 但 是 脚本 功能 被 设计 成 可 以 与 集群 功能 保持 兼容 。) 不 过 ， 这 条 规矩 并 不 是 强制 性 的 ， 从 
而 使 得 用 户 有 机 会 小 用 (abuse) Redis 单 实例 配置 (single instance configuration)， 代 价 是 这 样 
写 出 的 脚本 不 能 被 Redis 集群 所 兼容 。 


在 Lua 数据 类 型 和 Redis 数据 类 型 之 间 转 换 


“4 Lua 通过 call() 或 pcall() WAG Redis 命令 的 时 候 ， 命 邻 的 返回 值 会 被 转换 成 
Lua 数据 结构 。 同 样 地 ， 当 Lua 脚本 在 Redis 内 置 的 解释 器 里 运行 时 ，Lua 脚本 的 返回 值 也 
会 被 转换 成 Redis 协议 (protocol)， 然 后 由 EVAL 将 值 返 回 给 客户 端 。 


数据 类 型 之 间 的 转换 遵循 这 样 一 个 设计 原则 : 如 果 闻 一 个 Redis 值 转换 成 Lua 值 ， 之 后 再 将 
转换 所 得 的 Lua 值 转换 回 Redis 值 ， 那 么 这 个 转换 所 得 的 Redis 值 应 该 和 最 初时 的 Redis 值 
一 样 。 

换 句 话说 ， Lua 类 型 和 Redis 类 型 之 间 存 在 着 一 一 对 应 的 转换 关系 。 

以 下 列 出 的 是 详细 的 转换 规则 : 

从 Redis 转换 到 Lua : 


。 Redis integer reply -> Lua number / Redis 整数 转换 成 Lua 数字 

e Redis bulk reply -> Lua string / Redis bulk 回复 转换 成 Lua 字符 串 

e Redis multi bulk reply -> Lua table (may have other Redis data types nested) / Redis 多 
条 bulk 回复 转换 成 Lua 表 ， 表 内 可 能 有 其 他 别 的 Redis 数据 类 型 

e Redis status reply -> Lua table with a single ok field containing the status / Redis 状态 回 
复 转 换 成 Lua 表 ， 表 内 的 ok 域 包 含 了 状态 信息 

e Redis error reply -> Lua table with a single err field containing the error / Redis 错误 回复 
转换 成 Lua K, RAB err 域 包含 了 错误 信息 

e Redis Nil bulk reply and Nil multi bulk reply -> Lua false boolean type / Redis 的 Nil 回复 
和 Nil 多 条 回复 转换 成 Lua 的 布尔 值 false 


从 Lua 转换 到 Redis : 


e Lua number -> Redis integer reply / Lua 数字 转换 成 Redis 整数 

e Lua string -> Redis bulk reply / Lua 字符 串 转 换 成 Redis bulk 回复 

e Lua table (array) -> Redis multi bulk reply / Lua 表 ( 数 组 ) 转 换 成 Redis 多 条 bulk 回复 

e Lua table with a single ok field -> Redis status reply / 一 个 带 单个 ok 域 的 Lua R, 4% 
换 成 Redis 状态 回复 

e Lua table with a single err field -> Redis error reply / 一 个 带 单个 err 域 的 Lua 表 ， 转 
换 成 Redis 错误 回复 

e Lua boolean false -> Redis Nil bulk reply / Lua 的 布尔 值 false 转换 成 Redis 的 Nil 
bulk 回复 


从 Lua 转换 到 Redis 有 一 条 额外 的 规则 ， 这 条 规则 没有 和 它 对 应 的 从 Redis 转换 到 Lua 的 规 


则 : 


e Lua boolean true -> Redis integer reply with value of 1/ Lua 布尔 值 true 转换 成 Redis 
整数 回复 中 的 1 


以 下 是 几 个 类 型 转换 的 例子 : 


> eval "return 10" 0 
(integer) 10 
> eval "return {1,2,{3, 'Hello World! '}}" 0 
1) (integer) 1 
2) (integer) 2 
3) 1) (integer) 3 
2) "Hello world!" 


> eval "return redis.call('get','foo')" © 
"bar" 


在 上 面 的 三 个 代码 示例 里 ， 前 两 个 演示 了 如 何 将 Lua 值 转换 成 Redis 值 ， 最 后 一 个 例子 更 复 
条 一 些 ， 它 演示 了 一 个 将 Redis 值 转换 成 Lua 值 ， 然 后 再 将 Lua 值 转换 成 Redis 值 的 类 型 转 
过 程 。 


脚本 的 原子 性 


Redis 使 用 单个 Lua 解释 器 去 运行 所 有 脚本 ， 并 且 ， Redis 也 保证 脚本 会 以 原子 性 (atomic) 的 
方式 执行 : 当 某 个 脚本 正在 运行 的 时 候 ， 不 会 有 其 他 脚本 或 Redis 命令 被 执行 。 这 和 使 用 
MULTI | EXEC 包围 的 事务 很 类 似 。 在 其 他 别 的 客户 端 看 来 ， 脚 本 的 效果 (effect) 要 么 是 不 可 见 
的 (not visible)， 要 么 就 是 已 完成 的 (already completed). 


另 一 方面 ， 这 也 意味 着 ， 执 行 一 个 运行 缓慢 的 脚本 并 不 是 一 个 好 主意 。 写 一 个 跑 得 很 快 很 顺 

溜 的 脚本 并 不 难 ， 因 为 脚本 的 运行 开销 (overhead) 非 常 少 ， 但 是 当 你 不 得 不 使 用 一 些 跑 得 比较 
慢 的 脚本 时 ， 请 小 心 ， 因 为 当 这些 蜗 牛 脚本 在 慢 吞 吞 地 运行 的 时 候 ， 其 他 客户 端 会 因为 服务 

器 正 忙 而 无 法 执行 命 舍 。 


错误 处 理 


前 面 的 命令 介绍 部 分 说 过 ， redis.call() 和 redis.pcall() 的 唯一 区 别 在 于 它们 对 错误 处 
理 的 不 同 。 
4 redis.call() 在 执行 命令 的 过 程 中 发 生 错 误 时 ， 脚 本 会 停止 执行 ， 并 返回 一 个 脚本 错误 ， 
错误 的 输出 信息 会 说 明 错 误 造成 的 原因 : 

redis> lpush foo a 

(integer) 1 


redis> eval "return redis.call('get', 'foo')" 0 
(error) ERR Error running script (call to f_282297a0228f48cd3fc6a55de6316f31422f5d17): ER 


OSS 


和 redis.call() 不 同 ， redis.pcall() 出 错时 并 不 引发 (raise) 错 误 ， 而 是 返回 一 个 带 err 
域 的 Lua 表 (table)， 用 于 表示 错误 : 





redis 127.0.0.1:6379> EVAL "return redis.pcall('get', 'foo')" © 
(error) ERR Operation against a key holding the wrong kind of value 


带宽 和 EVALSHA 


EVAL 命令 要 求 你 在 每 次 执行 脚本 的 时 候 都 发 送 一 次 脚本 主体 (script body)。Redis 有 一 个 内 
部 的 缓存 机 制 ， 因 此 它 不 会 每 次 都 重新 编译 脚本 ， 不 过 在 很 多 场合 ， 付 出 无 谓 的 带宽 来 传送 
脚本 主体 并 不 是 最 佳 选择 。 


为 了 减少 带宽 的 消耗 ， Redis 实现 了 EVALSHA 命令 ， 它 的 作用 和 EVAL 一 样 ， 都 用 于 对 脚 
本 求 值 ， 但 它 接 受 的 第 一 个 参数 不 是 脚本 ， 而 是 脚本 的 SHA1 校 验 和 (sum)。 


EVALSHA 命令 的 表现 如 下 : 


٠ 如 果 服 务 器 还 记得 给 定 的 SHA1 校 验 和 所 指定 的 脚本 ， 那 么 执行 这 个 脚本 
٠ 如 果 服 务 器 不 记得 给 定 的 SHA1 校 验 和 所 指定 的 脚本 ， 那 么 它 返 回 一 个 特殊 的 错误 ， 提 
醒 用 户 使 用 EVAL 代替 EVALSHA 


以 下 是 示例 : 
> set foo bar 
OK 


> eval "return redis.call('get','foo')" © 
"bar" 


> evalsha 6bibf486c81ceb7edf3c093Ff4c48582e38c0e791 0 
"bar" 


> evalsha ffffffffffffffffffffffffffffffffffffffff 0 
(error) ~“NOSCRIPT~ No matching script. Please use [EVAL](/commands/eval). 


客户 端 库 的 底层 实现 可 以 一 直 乐 观 地 使 用 EVALSHA 来 代替 EVAL ， 并 期 望 着 要 使 用 的 脚本 
已 经 保存 在 服务 器 上 了 ， 只 有 当 NoscRIPT 错误 发 生 时 ， 才 使 用 EVAL 命令 重新 发 送 脚本 ， 
这 样 就 可 以 最 大 限度 地 节省 带宽 。 


这 也 说 明了 执行 EVAL 命令 时 ， 使 用 正确 的 格式 来 传递 键 名 参数 和 附加 参数 的 重要 性 : 因为 
如 果 将 参数 硬 写 在 脚本 中 ， 那 么 每 次 当 参 数 改变 的 时 候 ， 都 要 重新 发 送 脚 本 ， 即 使 脚本 的 主 
体 并 没有 改变 ， 相 反 ， 通 过 使 用 正确 的 格式 来 传递 键 名 参数 和 附加 参数 ， 就 可 以 在 脚本 主体 
不 变 的 情况 下 ， 直 接 使 用 EVALSHA 命令 对 脚本 进行 复 用 ， 免 去 了 无 谓 的 带宽 消耗 。 


脚本 缓存 


Redis 保证 所 有 被 运行 过 的 脚本 都 会 被 永久 保存 在 脚本 缓存 当中 ， 这 意味 着 ， 当 EVAL SBE 
一 个 Redis 实例 上 成 功 执行 某 个 脚本 之 后 ， 随 后 针对 这 个 脚本 的 所 有 EVALSHA 命令 都 会 成 
功 执行 。 


刷新 脚本 缓存 的 唯一 办 法 是 显 式 地 调用 scRIPT FLUSH 命令 ， 这 个 命令 会 清空 运行 过 的 所 有 脚 
本 的 缓存 。 通 常 只 有 在 云 计算 环境 中 ，Redis 实例 被 改作 其 他 客户 或 者 别 的 应 用 程序 的 实例 


时 ， 才 会 执行 这 个 命令 。 


缓存 可 以 长 时 间 储 存 而 不 产生 内 存 问题 的 原因 是 ， 它 们 的 体积 非常 小 ， 而 且 数 量 也 非常 少 ， 
即使 脚本 在 概念 上 类 似 于 实现 一 个 新 命 舍 ， 即 使 在 一 个 大 规模 的 程序 里 有 成 百 上 于 的 脚本 ， 
即使 这 些 脚本 会 经 常 修改 ， 即 便 如 此 ， 储 存 这 些 脚 本 的 内 存 仍然 是 微不足道 的 。 


事实 上 ， 用 户 会 发 现 Redis 不 移 除 缓存 中 的 脚本 实际 上 是 一 个 好 主意 。 上 比如 说 ， 对 于 一 个 和 
Redis 保持 持久 化 链接 (persistent connection) 的 程序 来 说 ， 它 可 以 确信 ， 执 行 过 一 次 的 脚本 
会 一 直 保 留 在 内 存 当 中 ， 因 此 它 可 以 在 流水 线 中 使 用 EVALSHA 命令 而 不 必 担 心 因为 找 不 到 
所 需 的 脚本 而 产生 错误 ( 稍 候 我 们 会 看 到 在 流水 线 中 执行 脚本 的 相关 问题 )。 


SCRIPT 命令 


Redis 提供 了 以 下 几 个 SCRIPT 命令 ， 用 于 对 脚本 子 系统 (scripting subsystem) 进 行 控制 : 


e SCRIPT FLUSH : 清除 所 有 脚本 缓存 

e SCRIPT EXISTS : 根据 给 定 的 脚本 校 验 和 ， 检 查 指定 的 脚本 是 否 存在 于 脚本 缓存 
。 SCRIPT LOAD : 将 一 个 脚本 装 入 脚本 缓存 ， 但 并 不 立即 运行 它 

e SCRIPT KILL : 杀 死 当前 正在 运行 的 脚本 


2s, PR) SBA) AS 
TRASHE, CEZAR E, WA WARS AL +44 (pure function), 
也 就 是 说 ， 脚 本 应 该 具有 以 下 属性 : 


。 对 于 同样 的 数据 集 输入 ， 给 定 相同 的 参数 ， 脚 本 执行 的 Redis 写 命 令 总 是 相同 的 。 脚 本 
执行 的 操作 不 能 依赖 于 任何 隐藏 ( 非 显 式 ) 数 据 ， 不 能 依赖 于 脚本 在 执行 过 程 中 、 或 脚本 在 
不 同 执行 时 期 之 间 可 能 变更 的 状态 ， 并 且 它 也 不 能 依赖 于 任何 来 自 VO 设备 的 外 部 输入 。 


使 用 系统 时 间 (system time)， 调 用 像 RANDOMKEY 那样 的 随机 命令 ， 或 者 使 用 Lua 的 随机 
数 生 成 器 ， 类 似 以 上 的 这 些 操 作 ， 都 会 造成 脚本 的 求 值 无 法 每 次 都 得 出 同 祥 的 结果 。 


为 了 确保 脚本 符合 上 面 所 说 的 属性 ， Redis 做 了 以 下 工作 : 


。 Lua 没有 访问 系统 时 间或 者 其 他 内 部 状态 的 命令 

٠ Redis 会 返回 一 个 错误 ， 阻 止 这 样 的 脚本 运行 : 这 些 脚 本 在 执行 随机 命令 之 后 (比如 
RANDOMKEY、 SRANDMEMBER && TIME 等 )， 还 会 执行 可 以 修改 数据 集 的 Redis f 
邻 。 如 果 脚 本 只 是 执行 只 读 操作 ， 那 么 就 没有 这 一 限制 。 注 意 ， 随 机 命令 并 不 一 定 就 指 
那些 带 RAND 字眼 的 命 舍 ， 任 何 带 有 非 确定 性 的 命令 都 会 被 认为 是 随机 命 舍 ， 比 如 
TIME 命令 就 是 这 方面 的 一 个 很 好 的 例子 。 

。 每 当 从 Lua 脚本 中 调用 那些 返回 无 序 元 素 的 命 舍 时 ， 执 行 命令 所 得 的 数据 在 返回 给 Lua 
之 前 会 先 执行 一 个 静默 (slient) 的 字典 序 排序 (lexicographical sorting)。 举 个 例子 ， 因 为 
Redis 的 Set 保存 的 是 无 序 的 元 素 ， 所 以 在 Redis 命令 行 客户 端 中 直接 执行 
SMEMBERS ， 返 回 的 元 素 是 无 序 的， 但 是 ， 假 如 在 脚本 中 执行 
redis.call("smembers", KEYS[1]) و‎ 那么 返回 的 总 是 排 过 序 的 元 素 。 

e 对 Lua 的 伪 随 机 数 生成 画 数 math.random 和 math.randomseed 进行 修改 ， 使 得 每 次 在 运 
行 新 脚本 的 时 候 ， 总 是 拥有 同样 的 seed 值 。 这 意味 着 ， 每 次 运行 脚本 时 ， 只 要 不 使 用 
math.randomseed و‎ 那么 math. random 产生 的 随机 数 序列 总 是 相同 的 。 


尽管 有 那么 多 的 限制 ， 但 用 户 还 是 可 以 用 一 个 简单 的 技巧 写 出 带 随机 行为 的 脚本 (如 果 他 们 需 
要 的 话 )。 


假设 现在 我 们 要 编写 一 个 Redis 脚本 ， 这 个 脚本 从 列表 中 弹出 N 个 随机 数 。 一 个 Ruby 写 的 
例子 如 下 : 


require 'rubygems' 
require 'redis' 


r = Redis.new 


RandomPushScript = <<EOF 
local i = tonumber (ARGV[1] ) 
local res 
while (i > 0) do 
res = redis.call('lpush',KEYS[1],math.random() ) 
i = i-1 
end 
return res 
EOF 


r.del(:mylist) 
puts r.eval(RandomPushScript, [:mylist], [10, rand(2**32)]) 


这 个 程序 每 次 运行 都 会 生成 带 有 以 下 元 素 的 列表 : 


> lrange mylist © -1 


1) "0.74509509873814" 
2) "0.87390407681181" 
3) "0.36876626981831" 
4) "0.6921941534114" 
5) "0.7857992587545" 
6) "0.57730350670279" 
7) "0.87046522734243" 
8) "0.09637165539729" 
9) "0.74990198051087" 


10) "0.17082803611217" 


上 面 的 Ruby 程序 每 次 都 只 生成 同样 的 列表 ， 用 途 并 不 是 太 大 。 那 么 ， 该 怎样 修改 这 个 脚本 ， 
使 得 它 仍然 是 一 个 纯 函 数 (符合 Redis 的 要 求 )， 但 是 每 次 调用 都 可 以 产生 不 同 的 随机 元 素 呢 ? 


一 个 简单 的 办 法 是 ， 为 脚本 添加 一 个 额外 的 参数 ， 让 这 个 参数 作为 Lua 的 随机 数 生成 器 的 
seed 值 ， 这 样 的 话 ， 只 要 给 脚本 传 入 不同 的 seed ， 脚 本 就 会 生成 不 同 的 列表 元 素 。 


以 下 是 修改 后 的 脚本 : 


RandomPushScript = <<EOF 
local i = tonumber(ARGV[1] ) 
local res 
math. randomseed(tonumber (ARGV[2] ) ) 
while (i > 0) do 
res = redis.call('lpush',KEYS[1],math.random() ) 
i = 1-1 
end 
return res 
EOF 


r.del(:mylist) 
puts r.eval(RandomPushScript, 1, :mylist,10, rand(2**32) ) 


尽管 对 于 同样 的 seed ， 上 面 的 脚本 产生 的 列表 元 素 是 一 样 的 (因为 它 是 一 个 纯 函 数 )， 但 是 只 
要 每 次 在 执行 脚本 的 时 候 传 人 不 同 的 seed ， 我 们 就 可 以 得 到 带 有 不 同 随机 元 素 的 列表 。 


Seed 会 在 复制 (replication link) 和 写 AOF 文件 时 作为 一 个 参数 来 传播 ， 保 证 在 载 人 AOF 文件 
或 附属 节点 (slave) 义 理 脚本 时 ， seed 仍然 可 以 及 时 得 到 更 新 。 


注意 ，Redis 实现 保证 math.random 和 math.randomseed 的 输出 和 运行 Redis 的 系统 架构 无 
关 ， 无 论 是 32 位 还 是 64 位 系统 ， 无 论 是 小 端 (little endian) 还 是 大 端 (big endian) 系 统 ， 这 两 
个 画 数 的 输出 总 是 相同 的 。 


全 局 变量 保护 


为 了 防止 不 必要 的 数据 泄漏 进 Lua 环境 ， Redis 脚本 不 允许 创建 全 局 变量 。 如 果 一 个 脚本 需 
要 在 多 次 执行 之 间 维 持 某 种 状态 ， 它 应 该 使 用 Redis key 来 进行 状态 保存 。 


企图 在 脚本 中 访问 一 个 全 局 变量 (不 论 这 个 变量 是 否 存在 ) 将 引起 脚本 停止 ， EVAL 命令 会 返回 


一 个 错误 : 


redis 127.0.0.1:6379> eval 'a=10' 0 
(error) ERR Error running script (call to f_933044db579a2f8fd45d8065f04a8d0249383e57): us 


“| = Bee > | 


Lua 的 debug 工具 ， 或 者 其 他 设施 ， 比 如 打印 (alter) 用 于 实现 全 局 保护 的 meta table ， 都 
可 以 用 于 实现 全 局 变量 保护 。 








实现 全 局 变量 保护 并 不 难 ， 不 过 有 时 候 还 是 会 不 小 心 而 为 之 。 一 旦 用 户 在 脚本 中 混入 了 Lua 
全 局 状态 ， 那 么 AOF 持久 化 和 复制 (replication) 都 会 无 法 保证 ， 所 以 ， 请 不 要 使 用 全 局 变 


Bo 


避免 引入 全 局 变量 的 一 个 诀窍 是 : 将 脚本 中 用 到 的 所 有 变量 都 使 用 local 关键 字 定 义 为 局 部 


zE 


库 


Redis 内 和 置 的 Lua 解释 器 加 载 了 以 下 Lua & : 


© base 
© table 
© string 
© math 
© debug 
© cjson 


© cmsgpack 


其 中 cjson 库 可 以 让 Lua 以 非常 快 的 速度 处 理 JSON 数据 ， 除 此 之 外 ， 其 他 别 的 都 是 Lua 
的 标准 库 。 


每 个 Redis 实例 都 保证 会 加 载 上 面 列举 的 库 ， 从 而 确保 每 个 Redis 脚本 的 运行 环境 都 是 相同 
的 。 


使 用 脚本 散发 Redis 日 志 


在 Lua 脚本 中 ， 可 以 通过 调用 redis.1log KARE Redis 日 志 (log) : 
redis.log(loglevel, message) 
Hh, message 参数 是 一 个 字符 串 ， 而 logleve 参数 可 以 是 以 下 任意 一 个 值 : 


© redis.LOG_DEBUG 
© redis.LOG VERBOSE 
© redis.LOG_NOTICE 


© redis.LOG WARNING 


上 面 的 这 些 等 级 (level) 和 标准 Redis 日 志 的 等 级 相对 应 。 


对 于 脚本 散发 (emit) 的 日 志 ， 只 有 那些 和 当前 Redis 实例 所 设置 的 日 志 等 级 相同 或 更 高 级 的 日 
志 才 会 被 散发 。 


以 下 是 一 个 日 志 示例 : 


redis.log(redis.LOG_WARNING, "Something is wrong with this script.") 


447 LMA WMS دع عر‎ 128015 : 


[32343] 22 Mar 15:21:39 # Something is wrong with this script. 


沙 箱 (sandbox) 和 最 大 执行 时 间 


脚本 应 该 仅仅 用 于 传递 参数 和 对 Redis 数据 进行 处 理 ， 它 不 应 该 尝试 去 访问 外 部 系统 (比如 文 
件 系 统 )， 或 者 执行 任何 系统 调用 。 


除 此 之 外 ， 脚 本 还 有 一 个 最 大 执行 时 间 限 制 ， 它 的 默认 值 是 5 秒 钟 ， 一 般 正 常 运作 的 脚本 通 
常 可 以 在 几 分 之 几 毫 秒 之 内 完成 ， 花 不 了 那么 多 时 间 ， 这 个 限制 主要 是 为 了 防止 因 编 程 错误 
而 造成 的 无 限 循环 而 设置 的 。 


最 大 执行 时 间 的 长 短 由 lua-time-limit 选项 来 控制 (以 毫秒 为 单位 )， 可 以 通过 编辑 
redis.conf 文件 或 者 使 用 CONFIG GET 和 CONFIG SET 命令 来 修改 它 。 


当 一 个 脚本 达到 最 大 执行 时 间 的 时 候 ， 它 并 不 会 自动 被 Redis R, AA Redis 必须 保证 脚 
本 执行 的 原子 性 ， 而 中 途 停止 脚本 的 运行 意味 着 可 能 会 留 下 未 义理 完 的 数据 在 数据 集 (data 
set) 里 面 。 


因此 ， 当 脚本 运行 的 时 间 超 过 最 大 执行 时 间 后 ， 以 下 动作 会 被 执行 : 


e Redis 记录 一 个 脚本 正在 超时 运行 

٠ Redis 开始 重新 接受 其 他 客户 端的 命令 请 求 ， 但 是 只 有 scRIPT kILL 和 
SHUTDOWN NOSAVE 两 个 命令 会 被 处 理 ， 对 于 其 他 命令 请 求 ， Redis 服务 器 只 是 简单 地 返 
回 Busy 错误 。 

e 可 以 使 用 scRIPT KILL 命令 将 一 个 仅 执 行 只 读 命令 的 脚本 杀 死 ， 因 为 只 读 命令 并 不 修改 
数据 ， 因 此 杀 死 这 个 脚本 并 不 破坏 数据 的 完整 性 

٠ 如 果 脚 本 已 经 执行 过 写 命 仿 ， 那 么 唯一 允许 执行 的 操作 就 是 SHUTDOWN NosAvE ， 它 通过 
停止 服务 器 来 阻止 当前 数据 集 写 入 磁 乱 


流水 线 (pipeline) 上 下 文 (context) 中 的 EVALSHA 


在 流水 线 请 求 的 上 下 文中 使 用 EVALSHA 命令 时 ， 要 特别 小 心 ， 因 为 在 流水 线 中 ， 必 须 保 证 
命令 的 执行 顺序 。 


一 旦 在 流水 线 中 因为 EVALSHA 命令 而 发 生 NOSCRIPT 错误 ， 那 么 这 个 流水 线 就 再 也 没有 办 
法 重新 执行 了 ， 否 则 的 话 ， 命 邻 的 执行 顺序 就 会 被 打 乱 。 


为 了 防止 出 现 以 上 所 说 的 问题 ， 客 户 端 库 实 现 应 该 实施 以 下 的 其 中 一 项 措施 : 


/ 


总 是 在 流水 线 中 使 用 EVAL AA 

。 检查 流水 线 中 要 用 到 的 所 有 命令 ， 找 到 其 中 的 EVAL 命令 ， 并 使 用 SCRIPT EXISTS tp 
今 检查 要 用 到 的 脚本 是 不 是 全 都 已 经 保存 在 缓存 里 面 了 。 如 果 所 需 的 全 部 脚本 都 可 以 在 
缓存 里 找到 ， 那 么 就 可 以 放心 地 将 所 有 EVAL MAAR EVALSHA 命令 ， 否 则 的 话 ， 就 
要 在 流水 线 的 顶端 (top) 将 缺少 的 脚本 用 SCRIPT LOAD 命令 加 上 去 。 


可 用 版 本 : 
>= 2.6.0 
时 间 复 条 度 : 


EVAL 和 EVALSHA 可 以 在 O(1) 复杂 度 内 找到 要 被 执行 的 脚本 ， 其 余 的 复杂 度 取决 于 执行 的 
脚本 本 身 。 


EVALSHA 


EVALSHA sha1 numkeys key [key ...] arg [arg ...] 

根据 给 定 的 shat 校 验 码 ， 对 缓存 在 服务 器 中 的 脚本 进行 求 值 。 

将 脚本 缓存 到 服务 器 的 操作 可 以 通过 SCRIPT LOAD 命令 进行 。 

这 个 命令 的 其 他 地 方 ， 比 如 参数 的 传人 方式 ， 都 和 EVAL 命令 一 样 。 
可 用 版 本 : 

>= 2.6.0 

时 间 复 杂 度 : 

根据 脚本 的 复杂 度 而 定 。 


redis> SCRIPT LOAD "return 'hello moto'" 
"232fd51614574cf0867b83d384a5e898cfd24e5a" 


redis> EVALSHA "232d51614574cf0867b83d384a5e898cfd24e5a" 0 
"hello moto" 


SCRIPT EXISTS 


SCRIPT EXISTS script [script ...[ 


给 定 一 个 或 多 个 脚本 的 SHA1 校 验 和 ， 返 回 一 个 包含 o 和 1 的 列表 ， 表 示 校 验 和 所 指定 
的 脚本 是 否 已 经 被 保存 在 缓存 当中 。 


关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参见 EVAL HT. 
可 用 版 本 : 

>= 2.6.0 

at SRE: 

O(N), N 为 给 定 的 SHA1 校 验 和 的 数量 。 

返回 值 : 


一 个 列表 ， 包 含 。 和 1 ， 前 者 表示 脚本 不 存在 于 缓存 ， 后 者 表示 脚本 已 经 在 缓存 里 面 了 。 
列表 中 的 元 素 和 给 定 的 SHA1 校 验 和 保持 对 应 关系 ， 上 比如 列表 的 第 三 个 元 素 的 值 就 表示 第 三 
个 SHA1 校 验 和 所 指定 的 脚本 在 缓存 中 的 状态 。 
redis> SCRIPT LOAD "return 'hello moto'" # 载 人 一 个 脚本 
"232fd51614574cf0867b83d384a5e898cfd24e5a" 


redis> SCRIPT EXISTS 232fd51614574cf0867b83d384a5e898cfd24e5a 
1) (integer) 1 


redis> SCRIPT FLUSH # 清空 缓存 
OK 


redis> SCRIPT EXISTS 232fd51614574cf0867b83d384a5e898cfd24e5a 
1) (integer) 0 


SCRIPT FLUSH 


SCRIPT FLUSH 


清除 所 有 Lua 脚本 缓存 。 


关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参见 EVAL 
可 用 版 本 : 

>= 2.6.0 

BRE: 


O(N), n 为 缓存 中 脚本 的 数量 。 


redis> SCRIPT FLUSH 
OK 


命 


A 
TA 


o 


SCRIPT KILL 


SCRIPT KILL 


杀 死 当前 正在 运行 的 Lua 脚本 ， 当 且 仅 当 这 个 脚本 没有 执行 过 任何 写 操 作 时 ， 这 个 命令 才 生 
效 。 


这 个 命令 主要 用 于 终止 运行 时 间 过 长 的 脚本 ， 比 如 一 个 因为 BUG 而 发 生 无 限 loop 的 脚本 ， 
诸如 此 类 。 


SCRIPT KILL 执行 之 后 ， 当 前 正在 运行 的 脚本 会 被 杀 死 ， 执 行 这 个 脚本 的 客户 端 会 从 EVAL 
命令 的 阻塞 当中 退出 ， 并 收 到 一 个 错误 作为 返回 值 。 

另 一 方面 ， 假 如 当前 正在 运行 的 脚本 已 经 执行 过 写 操 作 ， 那 么 即使 执行 SCRIPT KILL ， 也 无 
法 将 它 杀 死 ， 因 为 这 是 违反 Lua 脚本 的 原子 性 执行 原则 的 。 在 这 种 情况 下 ， 唯 一 可 行 的 办 法 
是 使 用 shuTpowN NosAvE 命令 ， 通 过 停止 整个 Redis 进程 来 停止 脚本 的 运行 ， 并 防止 不 完整 
(half-written) 的 信息 被 写 人 数据库 中 。 


关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参见 EVAL ARo 
可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

执行 成 功 返回 ok ， 否 则 返回 一 个 错误 。 


# 没有 脚本 在 执行 时 


redis> SCRIPT KILL 
(error) ERR No scripts in execution right now. 


# 成 功 杀 死 脚本 时 

redis> SCRIPT KILL 

OK 

(1.30s) 

# 尝试 杀 死 一 个 已 经 执行 过 写 操作 的 脚本 ， 失 败 

redis> SCRIPT KILL 

(error) ERR Sorry the script already executed write commands against the dataset. You can 


(1.69s) 


«| 7 F5) 











以 下 是 脚本 被 杀 死 之 后 ， 返 回 给 执行 脚本 的 客户 端的 错误 : 


redis> EVAL "while true do end" 0 
(error) ERR Error running script (call to f_694a5feiddb97a4c6a1bf299d9537c7d3d0f84e7): Sc 
(5.00s) 


4 | = H: 








SCRIPT LOAD 


SCRIPT LOAD script 

将 脚本 script 添加 到 脚本 缓存 中 ， 但 并 不 立即 执行 这 个 脚本 。 

EVAL 命令 也 会 将 脚本 添加 到 脚本 缓存 中 ， 但 是 它 会 立即 对 输入 的 脚本 进行 求 值 。 
如 果 给 定 的 脚本 已 经 在 缓存 里 面 了 ， 那 么 不 做 动作 。 


在 脚本 被 加 入 到 缓存 之 后 ， 通 过 EVALSHA 命 仿 ， 可 以 使 用 脚本 的 SHA1 校 验 和 来 调用 这 个 
脚本 。 


脚本 可 以 在 缓存 中 保留 无 限 长 的 时 间 ， 寺 到 执行 SCRIPT FLUSH 为 止 。 
关于 使 用 Redis 对 Lua 脚本 进行 求 值 的 更 多 信息 ， 请 参见 EVAL HSB. 
可 用 版 本 : 

>= 2.6.0 

时 间 复 条 度 : 

O(N), n 为 脚本 的 长 度 (以 字 节 为 单位 )。 

返回 值 : 

给 定 script 的 SHA1 校 验 和 


redis> SCRIPT LOAD "return 'hello moto'" 
"232fd51614574cf0867b83d384a5e898cfd24e5a" 


redis> EVALSHA 232fd51614574cf0867b83d384a5e898cfd24e5a 0 
"hello moto" 


Connection (连接 ) 


AUTH 


AUTH password 


通过 设置 配置 文件 中 requirepass 项 的 值 (使 用 命 兮 CONFIG SET requirepass password ), 可 


以 使 用 密码 来 保护 Redis 服务 器 。 


如 果 开 启 了 密码 保护 的 话 ， 在 每 次 连接 Redis 服务 器 之 后 ， 就 要 使 用 am 命令 解锁 ， 解 锁 
之 后 才能 使 用 其 他 Redis a. 


如 果 AuTH 命令 给 定 的 密码 password 和 配置 文件 中 的 密码 相符 的 话 ， 服 务 器 会 返回 ok 并 
开始 接受 命令 输入 。 


另 一 方面 ， 假 如 密码 不 匹配 的 话 ， 服 务 器 将 返回 一 个 错误 ， 并 要 求 客户 端 需 重新 输入 密码 。 


Warning 

因为 Redis 高 性 能 的 特点 ， 在 很 短 时 间 内 尝试 猜测 非常 多 个 密码 是 有 可 能 的 ， 因 此 请 确保 使 
用 的 密码 足够 复 休 和 足够 长 ， 以 免 遭 受 密码 猜测 攻击 。 

可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 
O(1) 
返回 值 : 


密码 匹配 时 返回 ok ， 否 则 返回 一 个 错误 。 


# 设置 密码 


redis> CONFIG SET requirepass Secret_password # 
OK 


redis> QUIT # 
[huangz@mypad]$ redis 


redis> PING # 
(error) ERR operation not permitted 


redis> AUTH wrong_password_testing # 
(error) ERR invalid password 


redis> AUTH secret_password # 
OK 

redis> PING # 
PONG 


# 清空 密码 


将 密码 设置 为 secret_password 


退出 再 连接 ， 让 新 密码 对 客户 端 生效 


未 验证 密码 ， 操 作 被 拒绝 


尝试 输入 错误 的 密码 


输入 正确 的 密码 


密码 验证 成 功 ， 可 以 正常 操作 命 分 了 


redis> CONFIG SET requirepass "" #4 通过 将 密码 设 为 空 字 符 来 清空 密码 


OK 
redis> QUIT 


$ redis # 重新 进入 客户 端 
A 





redis> PING # 执行 命令 不 再 需要 密码 ， 清 空 密码 操作 成 功 


PONG 


ECHO 


ECHO message 

打印 一 个 特定 的 信息 message ， 测 试 时 使 用 。 
可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 


message 自身 。 


redis> ECHO "Hello Moto" 
"Hello Moto" 


redis> ECHO "Goodbye Moto" 
"Goodbye Moto" 


PING 


PING 


使 用 客户 端 向 Redis 服务 器 发 送 一 个 pine ， 如 果 服 务 器 运作 正常 的 话 ， 会 返回 一 个 “PoNG 


通常 用 于 测试 与 服务 器 的 连接 是 否 仍然 生效 ， 或 者 用 于 测量 延迟 值 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

如 果 连 接 正常 就 返回 一 个 pons ， 否 则 返回 一 个 连接 错误 。 

# 客户 端 和 服务 器 连接 正常 


redis> PING 
PONG 


# 客户 端 和 服务 器 连接 不 正常 (网 络 不 正常 或 服务 器 未 能 正常 运行 ) 


redis 127.0.0.1:6379> PING 
Could not connect to Redis at 127.0.0.1:6379: Connection refused 


QUIT 


QUIT 

请 求 服务 器 关闭 与 当前 客户 端的 连接 。 

一 且 所 有 等 待 中 的 回复 (如 果 有 的 话 ) 顺 利 写 人 到 客户 端 ， 连 接 就 会 被 关闭 。 
可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 


总 是 返回 ok (但 是 不 会 被 打印 显示 ， 因 为 当时 Redis-cli 已 经 退出 )。 


$ redis 
redis> QUIT 


$ 


SELECT 


SELECT index 

切换 到 指定 的 数据 库 ， 数 据 库 索 引号 index 用 数字 值 指定 ， 以 o (PARISI. 
默认 使 用 。 号 数据 库 。 

可 用 版 本 : 

>= 1.0.0 


THERE: 


redis> SET db_number 0 # 默认 使 用 0 号 数据 库 
OK 


redis> SELECT 1 # 使 用 1 号 数据 库 
OK 


redis[1]> GET db_number # 已 经 切换 到 1 号 数据 库 ， 注 意 Redis 现在 的 命令 提示 符 多 了 个 [1] 
(nil) 


redis[1]> SET db_number 1 
OK 


redis[1]> GET db_number 
ev 





redis[1]> SELECT 3 # 再 切换 到 3 号 数据 库 
OK 


redis[3]> # 提示 符 从 [1] 改变 成 了 [3] 


Server (fk 44s) 


BGREWRITEAOF 


BGREWRITEAOF 
执行 一 个 AOF 文 件 重 写 操作 。 重 写 会 创建 一 个 当前 AOF 文件 的 体积 优化 版 本 。 


即使 BGREWRITEAOF 执行 失败 ， 也 不 会 有 任何 数据 丢失 ， 因 为 旧 的 AOF 文件 在 
BGREWRITEAOF 成 功 之 前 不 会 被 修改 。 


重 写 操 作 只 会 在 没有 其 他 持久 化 工作 在 后 台 执 行 时 被 触发 ， 也 就 是 说 : 


٠ 如 果 Redis 的 子 进 程 正在 执行 快照 的 保存 工作 ， 那 么 AOF 重 写 的 操作 会 被 预定 
(scheduled)， 等 到 保存 工作 完成 之 后 再 执行 AOF 重 写 。 在 这 种 情况 下 ， 
BGREWRITEAOF 的 返回 值 仍然 是 ok ， 但 还 会 加 上 一 条 额外 的 信息 ， 说 明 
BGREWRITEAOF 要 等 到 保存 操作 完成 之 后 才能 执行 。 在 Redis 2.6 或 以 上 的 版 本 ， 可 
以 使 用 INFO 命令 查看 BGREWRITEAOF 是 否 被 预定 。 

٠ 如 果 已 经 有 别 的 AOF 文件 重 写 在 执行 ， 那 么 BGREWRITEAOF 返回 一 个 错误 ， 并 且 这 
个 新 的 BGREWRITEAOF 请 求 也 不 会 被 预定 到 下 次 执行 。 


从 Redis 2.4 开始 ， AOF 重 写 由 Redis 自行 触发 ，BGREWRITEAOF 仅仅 用 于 手动 触发 重 
写 操 作 。 


请 移 步 持久 化 文档 (英文 ) 查看 更 多 相关 细节 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复杂 度 : 

O(N), n 为 要 追加 到 AOF 文件 中 的 数据 数量 。 


redis> BGREWRITEAOF 
Background append only file rewriting started 


BGSAVE 


在 后 台 异 步 (Asynchronously) 保 存 当 前 数据 库 的 数据 到 磁盘 。 


BGSAVE 命令 执行 之 后 立即 返回 ok ， 然 后 Redis fork 出 一 个 新 子 进程 ， 原 来 的 Redis 进程 
( 父 进程 ) 继 续 处 理 客户 端 请 求 ， 而 子 进程 则 负责 将 数据 保存 到 磁盘 ， 然 后 退出 。 


客户 端 可 以 通过 LASTSAVE 命 命 查 看 相关 人 信息， 判断 BGSAVE 命令 是 否 执行 成 功 。 
请 移 步 持久 化 文档 查看 更 多 相关 细节 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(N), AN 为 要 保存 到 数据 库 中 的 key 的 数量 。 


redis> BGSAVE 
Background saving started 


CLIENT CETNAME 


CLIENT GETNAME 
返回 CLIENT SETNAME 命令 为 连接 设置 的 名 字 。 


因为 新 创建 的 连接 默认 是 没有 名 字 的 ， 对 于 没有 名 字 的 连接 ， CLIENT GETNAME 返回 空白 
回复 。 


可 用 版 本 

>= 2.6.9 

时 间 复 条 度 

O(1) 

返回 值 

如 果 连 接 没有 设置 名 字 ， 那 么 返回 空白 回复 ; 如 果 有 设置 名 字 ， 那 么 返回 名 字 。 


# 新 连接 默认 没有 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
(nil) 


# 设置 名 字 


redis 127.0.0.1:6379> CLIENT SETNAME hello-world-connection 
OK 


# 返回 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
"hello-world-connection" 


CLIENT KILL 


CLIENT KILL ip:port 
关闭 地 址 为 ip:port 的 客户 端 。 
ip:port 应 该 和 CLIENT LIST 命令 输出 的 其 中 一 行 匹 配 。 


因为 Redis 使 用 单线 程 设 计 ， 所 以 当 Redis 正在 执行 命令 的 时 候 ， 不 会 有 客户 端 被 断 开 连 
接 。 


如 果 要 被 断 开 连 接 的 客户 端正 在 执行 命令 ， 那 么 当 这 个 命令 执行 之 后 ， 在 发 送 下 一 个 命令 的 
时 候 ， 它 就 会 收 到 一 个 网 络 错误 ， 告 知 它 自身 的 连接 已 被 关闭 。 


可 用 版 本 

>= 2.4.0 

时 间 复 条 度 

O(N), N 为 已 连接 的 客户 端 数量 。 

返回 值 

当 指 定 的 客户 端 存在 ， 且 被 成 功 关 闭 时 ， 返 回 ok 。 


# 列 出 所 有 已 连接 客户 端 


redis 127.0.0.1:6379< CLIENT LIST 
addr=127.0.0.1:43501 fd=5 age=10 1016-60 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-fr 


# 杀 死 当前 客户 端的 连接 


redis 127.0.0.1:6379> CLIENT KILL 127.0.0.1:43501 
OK 


# 之 前 的 连接 已 经 被 关闭 ，CLI 客户 端 又 重新 建立 了 连接 
# 之 前 的 端口 是 43501 ， 现 在 是 4 


redis 127.0.0.1:6379> CLIENT LIST 
addr=127.0.0.1:43504 fd=5 age=0 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-fre 


2 كك ————— 





CLIENT LIST 


CLIENT LIST 


以 人 类 可 读 的 格式 ， 返 回 所 有 连接 到 服务 器 的 客户 端 信息 和 统计 数据 。 


redis> CLIENT LIST 

addr=127.0.0.1:43143 fd=6 age=183 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-f 
addr=127.0.0.1:43163 fd=5 age=35 idle=15 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-f 
addr=127.0.0.1:43167 fd=7 age=24 idle=6 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=0 qbuf-fr 


——_—— SSS 
可 用 版 本 





>= 2.4.0 

时 间 复 条 度 

O(N), N 为 连接 到 服务 器 的 客户 端 数量 。 
返回 值 
命令 返回 多 行 字 符 串 ， 这 些 字符 串 按 以 下 形式 被 格式 化 : 


٠ 每 个 已 连接 客户 端 对 应 一 行 (以 LF 分 割 ) 
。 每 行 字 符 串 由 一 系列 属性 = 值 形式 的 域 组 成 ， 每 个 域 之 间 以 空格 分 开 


以 下 是 域 的 含义 : 


e addr : 客户 端的 地 址 和 端口 

。 fd : 套 接 字 所 使 用 的 文件 描述 符 

e age : 以 秒 计算 的 已 连接 时 长 

e idle : 以 秒 计算 的 空闲 时 长 

e flags : 客户 端 flag ( 见 下 文 ) 

。 db : 该 客户 端正 在 使 用 的 数据 库 ID 

。 sub : 已 订阅 频道 的 数量 

e psub : اه عماسم‎ 

© multi : 在 事务 中 被 执行 的 命 T 兮 数量 

e qbuf : 查询 缓冲 区 的 长 度 〈 字 节 为 单位 ， 6 表示 没有 分 配 查询 缓冲 区 ) 

© qbuf-free : 查询 缓冲 区 剩余 空间 的 长 度 ( 字 节 为 单位 ， 0 表示 没有 剩余 空间 ) 

。 o : 输出 缓冲 区 的 长 度 ( 字 节 为 单位 ， 6 表示 没有 分 配 输出 缓冲 区 ) 

e ol : 输出 列表 包含 的 对 象 数量 〈 当 输出 缓冲 区 没有 剩余 空间 时 ， 命 令 回 复 会 以 字符 串 
对 象 的 形式 被 人 队 到 这 个 队列 里 ) 

e omen : 输出 缓冲 区 和 输出 列表 占用 的 内 存 总 量 

© events : 文件 描述 符 事 件 ( 见 下 文 ) 


[=] 


。 cmd : 最 近 一 次 执行 的 命令 
客户 端 flag 可 以 由 以 下 部 分 组 成 : 


。 0 : 客户 端 是 MONITOR 模式 下 的 附属 节点 (slave) 
e s : 客户 端 是 一 般 模式 下 (normal) 的 附属 节点 

。 M : 客户 端 是 主 节点 (master) 

。 x : 客户 端正 在 执行 事务 

e b : 客户 端正 在 等 待 阻塞 事件 

。 i : 客户 端正 在 等 待 VM VO 操作 (ARF) 

一 个 受 监视 (watched) 的 键 已 被 修改 ， ExEc 命令 将 失败‏ : واه 
e。 c :在 将 回复 完整 地 写 出 之 后 ， 关 闭 链接‏ 

» u :客户 端 未 被 阻塞 (unblocked) 

٠ A : 尽 可 能 快 地 关闭 连接 

٠ N :未 设置 任何 flag 


文件 描述 符 事件 可 以 是 : 


。 r :客户 端 套 接 字 (在 事件 loop رط‎ 是 可 读 的 (readable) 
e w :客户 端 套 接 字 (在 事件 loop رط‎ 是 可 写 的 (writeable) 


Note 


AT debug 的 需要 ， 经 常会 对 域 进 行 添加 和 删除 ， 一 个 安全 的 Redis 客户 端 应 该 可 以 对 
CLIENT LIST 的 输出 进行 相应 的 处 理 (parse) ， 比 如 忽略 不 存在 的 域 ， 跳 过 未 知 域 ， 诸 如 此 


CLIENT SETNAME 


CLIENT SETNAME connection-name 
为 当前 连接 分 配 一 个 名 字 。 


这 个 名 字 会 显示 在 CLIENT LIST 命令 的 结果 中 ， 用 于 识别 当前 正在 与 服务 器 进行 连接 的 客户 


举 个 例子 ， 在 使 用 Redis 构建 队列 (queue) 时 ， 可 以 根据 连接 负责 的 任务 (role), 8 
S44 (producer) 和 信息 消费 者 (consumer) 分 别 设置 不 同 的 名 字 。 


名 字 使 用 Redis 的 字符 串 类 型 来 保存 ， 最 大 可 以 占用 512 MB 。 另外 ， 为 了 避免 和 CLIENT 
LIST 命令 的 输出 格式 发 生 冲突 ， 名 字 里 不 允许 使 用 空格 。 


要 移 除 一 个 连接 的 名 字 ， 可 以 将 连接 的 名 字 设 为 空 字符 串 "" 。 

使 用 CLIENT GETNAME 命令 可 以 取出 连接 的 名 字 。 

新 创建 的 连接 默认 是 没有 名 字 的 。 

Tip 

在 Redis 应 用 程序 发 生 连 接 泄漏 时 ， 为 连接 设置 名 字 是 一 种 很 好 的 debug 手段 。 
可 用 版 本 

>= 2.6.9 

时 间 复 杂 度 

O(1) 

返回 值 


设置 成 功 时 返回 ok 。 


# 新 连接 默认 没有 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
(nil) 


# 设置 名 字 


redis 127.0.0.1:6379> CLIENT SETNAME hello-world-connection 
OK 


# 返回 名 字 


redis 127.0.0.1:6379> CLIENT GETNAME 
"hello-world-connection" 


# 在 客户 端 列表 中 查看 


redis 127.0.0.1:6379> CLIENT LIST 
addr=127.0.0.1:36851 

fd=5 

name=hello-world-connection # <- ZF 
age=51 


# 清除 名 字 


redis 127.0.0.1:6379> CLIENT SETNAME # 只 用 空格 是 不 行 的 ! 
(error) ERR Syntax error, try CLIENT (LIST | KILL ip:port) 
redis 127.0.0.1:6379> CLIENT SETNAME "" # 必须 双 引 号 显示 包围 
OK 

redis 127.0.0.1:6379> CLIENT GETNAME # 清除 完毕 


(nil) 


CONFIG GET 


CONFIG GET parameter 


CONFIG GET 命令 用 于 取得 运行 中 的 Redis 服务 器 的 配置 参数 (configuration parameters), 
在 Redis 2.4 版 本 中 ， 有 部 分 参数 没有 办 法 用 conric cet 访问 ， 但 是 在 最 新 的 Redis 2.6 版 
本 中 ， 所 有 配置 参数 都 已 经 可 以 用 coNFIG GET 访问 了 。 


CONFIG GET 接受 单个 参数 parameter 作为 搜索 关键 字 ， 查 找 所 有 匹配 的 配置 参数 ， 其 中 
参数 和 值 以 “ 键 - 值 对 "(key-value pairs) 的 方式 排列 。 


比如 执行 coNFI6 GET s* 命令 ， 服 务 器 就 会 返回 所 有 以 s 开头 的 配置 参数 及 参数 的 值 : 


redis> CONFIG GET s* 


1) "save" # 参数 名 : save 

2) "900 1 300 10 60 10000" # save 参数 的 值 

3) "slave-serve-stale-data" # 参数 名 : slave-serve-stale-data 
4) "yes" # slave-serve-stale-data 参数 的 值 
5) "set-max-intset-entries" # ٠. 

6) "542" 

7) "slowlog-1log-slower - than" 

8) "1000" 

9) "slowlog-max-len" 

10) "1000" 


如 果 你 只 是 寻找 特定 的 某 个 参数 的 话 ， 你 当然 也 可 以 直接 指定 参数 的 名 字 : 


redis> CONFIG GET slowlog-max-len 
1) "slowlog-max-len" 
2) "1000" 


使 用 命令 coNFIG cet * ， 可 以 列 出 coNFIG GET 命令 支持 的 所 有 参数 : 


redis> CONFIG GET * 
1) "dir" 

2) "/var/lib/redis" 
3) "dbfilename" 


4) "dump. rdb" 

5) "requirepass" 
6) (nil) 

7) "“masterauth" 
8) (nil) 

9) "maxmemory" 
10) "gu 


11) "maxmemory-policy" 
12) "volatile-lru" 
13) "maxmemory-samples" 


14) Mgnt 

15) "timeout" 
16) "gu 

17) "appendonly" 
18) "ho" 

# 


49) "loglevel" 
50) "verbose" 


所 有 被 CONFIG SET 所 支持 的 配置 参数 都 可 以 在 配置 文件 redis.conf 中 找到 ， 不 过 
CONFIG GET 和 coNFIG SET 使 用 的 格式 和 redis.conf 文件 所 使 用 的 格式 有 以 下 两 点 不 同 : 


e 10kb . 2gb 这 些 在 配置 文件 中 所 使 用 的 储存 单位 缩写 ， 不 可 以 用 在 core 命令 中 ， 
CONFIG SET 的 值 只 能 通过 数字 值 显 式 地 设 定 。 像 CONFIG SET xxx 1k 这 样 的 命令 是 错误 
的 ， 正 确 的 格式 是 CONFIG SET xxx 1000 。 

e save 选项 在 redis.conf 中 是 用 多 行文 字 储 存 的 ， 但 在 coNFI6 cet 命令 中 ， 它 只 打印 一 
行文 字 。 以 下 是 save 选项 在 redis.conf 文件 中 的 表 
示 : save 900 1``save 300 10``save 60 10000 但 是 CONFIG GET 命令 的 输出 只 有 一 
ÍT : redis&gt; CONFIG GET save``1) "save"``2) "900 1 300 10 60 10000" 上 面 save 参数 
的 三 个 值 表 示 : 在 900 MARYA 1 key 被 改动 ， 或 者 300 MARYA 10 个 key 被 
改动 ， 又 或 者 60 秒 内 最 少 有 1000 个 key 被 改动 ， 以 上 三 个 条 件 随 便 满足 一 个 ， 就 触发 


一 次 保存 操作 。 
可 用 版 本 : 
>= 2.0.0 


时 间 复 杂 度 : 


不 明确 
返回 值 
给 定 配置 参数 的 值 。 


CONFIG RESETSTAT 


CONFIG RESETSTAT 
AE /NFO 命令 中 的 某 些 统计 数据 ， 包 括 : 


e Keyspace hits ( 键 空间 命中 次 数 ) 

。 Keyspace misses ( 键 空间 不 命中 次 数 ) 

e Number of commands processed (执行 命令 的 次 数 ) 

e Number of connections received (连接 服务 器 的 次 数 ) 

e Number of expired keys (过 期 key 的 数量 ) 

٠ Number of rejected connections (被 拒绝 的 连接 数量 ) 

٠ Latest fork(2) time( 最 后 执行 fork(2) 的 时 间 ) 

e The aof_delayed_fsync counter( aof_delayed_fsync 计数 器 的 值 ) 


可 用 版 本 : 
>= 2.0.0 


时 间 复 杂 度 : 


# 重读 前 


redis 127.0.0.1:6379> INFO 
# Server 
redis_version:2.5.3 
redis_git_sha1:d0407c2d 
redis_git_dirty:0 
arch_bits:32 
multiplexing_api:epoll 
gcc_version:4.6.3 
process_id:11095 
run_id:efif6b6c7392e52d6001eaf777acbe547d1192e2 
tcp_port:6379 
uptime_in_seconds:6 
uptime_in_days:0 
lru_clock:1205426 


# Clients 
connected_clients:1 
client_longest_output_list:0 
client_biggest_input_buf:0 
blocked_clients:0 


# Memory 

used_memory: 331076 
used_memory_human: 323 . 3216 
used_memory_rss:1568768 
used_memory_peak: 293424 


used_memory_peak_human: 286.55K 
used_memory_lua:16384 
mem_fragmentation_ratio:4.74 
mem_allocator:jemalloc-2.2.5 


# Persistence 

loading:0 

aof_enabled:0 
changes_since_last_save:0 
bgsave_in_progress:0 
last_save_time:1333260015 
last_bgsave_status:ok 
bgrewriteaof_in_progress:0 


# Stats 
total_connections_received:1 
total_commands_processed:0 
instantaneous_ops_per_sec:0 
rejected_connections:0 
expired_keys:0 
evicted_keys:0 
keyspace_hits:0 
keyspace_misses:0 
pubsub_channels:0 
pubsub_patterns:0 
latest_fork_usec:0 


# Replication 
role:master 
connected_slaves:0 


# CPU 

used_cpu_sys:0.01 
used_cpu_user:0.00 
used_cpu_sys_children:0.00 
used_cpu_user_children:0.00 


# Keyspace 
00 : keys=20, expires=0 


# BE 


redis 127.0.0.1:6379> CONFIG RESETSTAT 
OK 


# 重 置 后 


redis 127.0.0.1:6379> INFO 
# Server 
redis_version:2.5.3 
redis_git_sha1:d0407c2d 
redis_git_dirty:0 
arch_bits:32 
multiplexing_api:epoll 
gcc_version:4.6.3 
process_id:11095 
run_id:efif6b6c7392e52d6001eaf777acbe547d1192e2 
tcp_port:6379 
uptime_in_seconds:134 
uptime_in_days:0 
lru_clock:1205438 


# Clients 
connected_clients:1 
client_longest_output_list:0 
client_biggest_input_buf:0 
blocked_clients:0 


# Memory 

used_memory: 331076 
used_memory_human: 323.32K 
used_memory_rss:1568768 


used_memory_peak:330280 
used_memory_peak_human:322.54K 
used_memory_lua:16384 
mem_fragmentation_ratio:4.74 
mem_allocator:jemalloc-2.2.5 


# Persistence 

loading:0 

aof_enabled:0 
changes_since_last_save:0 
bgsave_in_progress:0 
last_save_time:1333260015 
last_bgsave_status:ok 
bgrewriteaof_in_progress:0 


# Stats 
total_connections_received:0 
total_commands_processed:1 
instantaneous_ops_per_sec:0 
rejected_connections:0 
expired_keys:0 
evicted_keys:0 
keyspace_hits:0 
keyspace_misses:0 
pubsub_channels:0 
pubsub_patterns:0 
latest_fork_usec:0 


# Replication 
role:master 
connected_slaves:0 


# CPU 

used_cpu_sys:0.05 
used_cpu_user:0.02 
used_cpu_sys_children:0.00 
used_cpu_user_children:0.00 


# Keyspace 
00 : keys=20, expires=0 


CONFIG REWRITE 


CONFIG REWRITE 


CONFIG REWRITE 命令 对 启动 Redis 服务 器 时 所 指定 的 redis.conf 文件 进行 改写 : 因为 
CONFIG SET 命令 可 以 对 服务 器 的 当前 配置 进行 修改 ， 而 修改 后 的 配置 可 能 和 redis.cont 
文件 中 所 描述 的 配置 不 一 样 ， CONFIG REWRITE 的 作用 就 是 通过 尽 可 能 少 的 修改 ， 将 服务 
器 当前 所 使 用 的 配置 记录 到 redis.conf 文件 中 。 


重 写 会 以 非常 保守 的 方式 进行 : 


٠ RA redis.conf 文件 的 整体 结构 和 注释 会 被 尽 可 能 地 保留 。 

٠ 如 果 一 个 选项 已 经 存在 于 原 有 redis.conf 文件 中 ， 那么 对 该 选项 的 重 写 会 在 选项 原本 
所 在 的 位 置 ( 行 号 ) 上 进行 。 

٠ 如 果 一 个 选项 不 存在 于 原 有 redis.conf 文件 中 ， 并 且 该 选项 被 设置 为 默认 值 ， 那么 重 
写 程 序 不 会 料 这 个 选项 添加 到 重 写 后 的 redis.conf 文件 中 。 

8 如 果 一 个 选项 不 存在 于 原 有 redis.conf 文件 中 ， 并 且 该 选项 被 设置 为 非 默认 值 ， 那么 
这 个 选项 将 被 添加 到 重 写 后 的 redis.conf 文件 的 末尾 。 

。 未 使 用 的 行 会 被 留 白 。 比如 说 ， 如 果 你 在 原 有 redis.conf 文件 上 设置 了 数 个 关于 
save 选项 的 参数 ， 但 现在 你 将 这 些 save 参数 的 一 个 或 全 部 都 关闭 了 ， 那么 这 些 不 再 
使 用 的 参数 原本 所 在 的 行 就 会 变 成 空白 的 。 


即使 启动 服务 器 时 所 指定 的 redis.co 文件 已 经 不 再 存在 ， CONFIG REWRITE 命令 也 可 
以 重新 构建 并 生成 出 一 个 新 的 redis.conf 文件 。 


另 一 方面 ， 如 果 和 启动 服务 器 时 没有 载 入 redis.conf 文件 ， 那么 执行 CONFIG REWRITE 命 


今 郊 引发 一 个 错误 。 


原子 性 重 写 


对 redis.conf 文件 的 重 写 是 原子 性 的 ， 并 且 是 一 致 的 : 如 果 重 写 出 错 或 重 写 期 间 服 务 器 月 
溃 ， PABSAK, RA redis.conf 文件 不 会 被 修改 。 如 果 重 写成 功 ， 那么 redis.conf 
文件 为 重 写 后 的 新 文件 。 


可 用 版 本 


>= 2.8.0 


返回 值 


一 个 状态 值 : 如 果 配 置 重 写成 功 则 返回 ok ， 失 败 则 返回 一 个 错误 。 


测试 


以 下 是 执行 CONFIG REWRITE 前 ， RABI Redis 服务 器 的 redis.conf 文件 中 关于 
appendonly 选项 的 设置 : 


# ,.， 其 他 选项 
appendonly no 


# ..， 其 他 选项 


在 执行 以 下 命令 之 后 : 


127.0.0.1:6379> CONFIG GET appendonly # appendonly 处 于 关闭 状态 
1) "appendonly" 
2) "ho" 


127.0.0.1:6379> CONFIG SET appendonly yes # 打开 appendonly 
OK 


127.0.0.1:6379> CONFIG GET appendonly 
1) "appendonly" 


2) "yes" 
127.0.0.1:6379> CONFIG REWRITE # 将 appendonly 的 修改 写 入 到 redis.conf 中 
OK 


# ... 其 他 选项 
appendonly yes 


# ... 其 他 选项 


CONFIG SET 


CONFIG SET parameter value 
CONFIG SET 命令 可 以 动态 地 调整 Redis 服务 器 的 配置 (configuration) 而 无 须 重 启 。 
你 可 以 使 用 它 修 改 配置 参数 ， 或 者 改变 Redis 的 持久 化 (Persistence) 方 式 。 


CONFIG SET 可 以 修改 的 配置 参数 可 以 使 用 命令 coNFIG GET * 来 列 出 ， 所 有 被 CONFIG 
SET 修改 的 配置 参数 都 会 立即 生效 。 


关于 CONFIG SET 命令 的 更 多 消息 ， 请 参见 命令 CONFIG GET 的 说 明 。 
关于 如 何 使 用 CONFIG SET 命令 修改 Redis 持久 化 方式 ， 请 参见 Redis Persistence 。 
可 用 版 本 : 

>= 2.0.0 

时 间 复 杂 度 : 

不 明确 

返回 值 : 

当 设 置 成 功 时 返回 ok ， 否 则 返回 一 个 错误 。 


redis> CONFIG GET slowlog-max-len 
1) "slowlog-max-len" 
2) "1024" 


redis> CONFIG SET slowlog-max-len 10086 
OK 


redis> CONFIG GET slowlog-max-len 
1) "slowlog-max-len" 
2) "10086" 


DBSIZE 


DBSIZE 

返回 当前 数据 库 的 key 的 数量 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

当前 数据 库 的 key 的 数量 。 


redis> DBSIZE 
(integer) 5 


redis> SET new_key "hello_moto" 
OK 


redis> DBSIZE 
(integer) 6 


# 增加 一 个 key 试 试 


DEBUG OBJECT 


DEBUG OBJECT key 
DEBUG OBJECT Æ- NHRD, CH GARE P 101ل‎ A. 

查看 OBJECT 命令 获取 更 多 信息 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

O(1) 

返回 值 : 

ky 存在 时 ， 返 回 有 关 信息 。 当 key 不 存在 时 ， 返 回 一 个 错误 。‏ كلا 


redis> DEBUG OBJECT my_pc 
Value at:0xb6838d20 refcount:1 encoding:raw serializedlength:9 lru:283790 lru_seconds_idl 


redis> DEBUG OBJECT your_mac 
(error) ERR no such key 


Bes =E eII IMIM 





DEBUG SEGFAULT 


DEBUG SEGFAULT 

执行 一 个 不 合法 的 内 存 访 问 从 而 让 Redis AA, RTA AN AF BUG 模拟 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

不 明确 

返回 值 : 

无 


redis> DEBUG SEGFAULT 
Could not connect to Redis at: Connection refused 


not connected> 


FLUSHALL 


FLUSHALL 

清空 整个 Redis 服务 器 的 数据 (删除 所 有 数据 库 的 所 有 key )。 
此 命 全 从 不 失败 。 

可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

尚未 明确 


redis> DBSIZE # 0 号 数据 库 的 key 数量 
(integer) 9 


redis> SELECT 1 # 切换 到 1 号 数据 库 

OK 

redis[1]> DBSIZE #1 号 数据 库 的 key 数量 
(integer) 6 

redis[1]> flushall # 清空 所 有 数据 库 的 所 有 key 
OK 

redis[1]> DBSIZE # 不 但 1 号 数据 库 被 清空 了 


(integer) 0 


redis[1]> SELECT 0 
OK 


t+ 


0 号 数据 库 ( 以 及 其 他 所 有 数据 库 ) 也 一 样 


redis> DBSIZE 
(integer) 0 


FLUSHDB 


FLUSHDB 

清空 当前 数据 库 中 的 所 有 key。 
此 命令 从 不 失败 。 

可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 


总 是 返回 ok 。 


redis> DBSIZE # 清空 前 的 key 数量 
(integer) 4 


redis> FLUSHDB 
OK 


at 
Het 
T 


redis> DBSIZE # ( 
(integer) 0 


的 key 数量 


INFO 


INFO [section] 


以 一 种 易于 解释 (parse) 且 易 于 阅读 的 格式 ， 返 回 关 于 Redis 服务 器 的 各 种 信息 和 统计 数 


值 。 


通过 给 定 可 选 的 参数 section ， 可 以 让 命 合 只 返回 某 一 部 分 的 信息 : 


server : 一 般 Redis 服务 器 信息 ， 包含 以 下 域 


> redis_version : Redis 服务 器 版 本 > redis_git_sha1 : Git SHA1 > redis_git_dirty : 
Git dirty flag > os : Redis 服务 器 的 宿主 操作 系统 > arch_bits :架构 (32 或 64 位) > 
multiplexing_api : Redis 所 使 用 的 事件 义理 机 制 > gcc_version : 编译 Redis 时 所 使 用 
的 GCC 版 本 > process_id :服务 器 进程 的 PID > run_ia : Redis 服务 器 的 随机 标识 符 
(用 于 Sentinel 和 集群 ) > tcp_port : TCP/IP 监听 端口 > uptime_in_seconds : 8 
Redis 服务 器 启动 以 来 ， 经 过 的 秒 数 > uptime_in_days : 自 Redis 服务 器 启动 以 来 ， 经 
过 的 天 数 > * 1ru_clock : 以 分 钟 为 单位 进行 自 增 的 时 钟 ， 用 于 LRU 管理 


clients :已 连接 客户 端 信息 ， 包 含 以 下 域 : 


> connected_clients :已 连接 客户 端的 数量 (不 包括 通过 从 属 服务 器 连接 的 客户 端 ) > 
client_longest_output_list : 当前 连接 的 客 户 端 当中 ， 最 长 的 输出 列表 > 
client_longest_input_buf :当前 连接 的 客户 端 当 中 ， 最 大 输入 缓存 > blocked clients : 
正在 等 待 阻塞 命令 (BLPOP、BRPOP、BRPOPLPUSH) 的 客户 端的 数量 


memory : 内 存 信息 ， 包 含 以 下 域 : 


> used_memory :由 Redis 分 配器 分 配 的 内 存 总 量 ， 以 字 节 (byte) 为 单位 > 
used_memory_human : 以 人 类 可 读 的 格式 返回 Redis 分 配 的 内 存 总 量 > used_memory_rss : 
从 操作 系统 的 角度 ， 返 回 Redi 已 分 配 的 内 存 总 量 ( 俗 称 常 驻 集 大 小 ) 。 这 个 值 和 top 
ps 等 命令 的 输出 一 致 。 > used_memory_peak : Redis 的 内 存 消耗 峰值 (以 字 节 为 单 
位 ) > used_memory_peak_human : 以 人 类 可 读 的 格式 返回 Redis 的 内 存 消耗 峰值 > 
used_memory_lua : Lua 引擎 所 使 用 的 内 存 大 小 〈 以 字 节 为 单位 ) > 
mem_fragmentation_ratio . used_memory_rss 和 used_memory 之 间 的 比率 > 
mem_allocator :在 编译 时 指定 的 ， Redis 所 使 用 的 内 存 分 配器 。 可 以 是 libc 、 jemalloc 
或 者 tcmalloc 。 > > 在 理想 情况 下 ， used_memory_rss 的 值 应 该 只 比 used_memory 稍微 
高 一 点 儿 。 当 rss &gt; used ， 且 两 者 的 值 相差 较 大 时 ， 表 示 存 在 (内 部 或 外 部 的 ) 内 
存 碎 片 。 内 存 碎 片 的 比率 可 以 通过 mem_fragmentation_ratio 的 值 看 出 。 当 

used &gt; rss 时 ， 表示 Redis 的 部 分 内 存 被 操作 系统 换 出 到 交换 空间 了 ， 在 这 种 情况 
下 ， 操 作 可 能 会 产生 明显 的 延迟 。 > > Because Redis does not have control over how 
its allocations are mapped to memory pages, high used_memory_rss is often the result 


of a spike in memory usage. > > 当 Redis 释放 内 存 时 ， 分 配器 可 能 会 ， 也 可 能 不 会 ， 将 
内 存 返 还 给 操作 系统 。 如 果 Redis 释放 了 内 存 ， 却 没有 将 内 存 返 还 给 操作 系统 ， 那 么 
used_memory A 44 FT BI E 和 操 VERR ELTA Redis 内 存 占 用 并 不 一 致 。 查看 
used_memory_peak 的 值 可 以 验证 这 种 情况 是 否 发 生 。 


e persistence : RDB 和 aor 的 相关 信息 
e stats :一 般 统计 信息 
e replication : 主 / 从 复制 信息 
。 cpu : CPU 计算 量 统计 信息 
e commandstats : Redis 命令 统计 信息 
e cluster : Redis 集群 信息 
e keyspace : 数据库 相 关 的 统计 信息 
除 上 面 给 出 的 这 些 值 以 外 ， 参 数 还 可 以 是 下 面 这 两 个 : 


e all : 返回 所 有 信息 
e default : 返回 默认 选择 的 信息 


当 不 带 参数 直接 调用 INFO mast, (RA default 作为 默认 参数 。 
Note 
不 同 版 本 的 Redis 可 能 对 返回 的 一 些 域 进行 了 增加 或 删 减 。 


因此 ， 一 个 健壮 的 客户 端 程序 在 对 /NFO 命令 的 输出 进行 分 析 时 ， 应 该 能 够 跳 过 不 认识 的 
域 ， 并 且 妥 善 地 处 理 丢 失 不 见 的 域 。 


可 用 版 本 : 
>= 1.0.0 


时 间 复 杂 度 : 


具体 请 参见 下 面 的 测试 代码 。 


redis> INFO 

# Server 
redis_version:2.5.9 
redis_git_sha1:473f3090 
redis_git_dirty:0 

os:Linux 3.3.7-1-ARCH i686 
arch_bits:32 
multiplexing_api:epoll 
gcc_version:4.7.0 
process_id:8104 

run_id: bc9e20c6f0aac67d0d396ab950940ae4d1479ad1 
tcp_port:6379 
uptime_in_seconds:7 
uptime_in_days:0 
lru_clock:1680564 


# Clients 
connected_clients:1 
client_longest_output_list:0 
client_biggest_input_buf:0 
blocked_clients:0 


# Memory 

used_memory : 439304 
used_memory_human: 429.01K 
used_memory_rss:13897728 
used_memory_peak:401776 
used_memory_peak_human:392.36K 
used_memory_lua: 20480 
mem_fragmentation_ratio:31.64 
mem_allocator: jemalloc-3.0.0 


# Persistence 

loading:0 
rdb_changes_since_last_save:0 
rdb_bgsave_in_progress:0 
rdb_last_save_time:1338011402 
rdb_last_bgsave_status:ok 
rdb_last_bgsave_time_sec:-1 
rdb_current_bgsave_time_sec:-1 
aof_enabled:0 
aof_rewrite_in_progress:0 
aof_rewrite_scheduled:0 
aof_last_rewrite_time_sec:-1 
aof_current_rewrite_time_sec:-1 





# Stats 
total_connections_received:1 
total_commands_processed:0 
instantaneous_ops_per_sec:0 
rejected_connections:0 
expired_keys:0 
evicted_keys:0 
keyspace_hits:0 
keyspace_misses:0 
pubsub_channels:0 
pubsub_patterns:0 
latest_fork_usec:0 


# Replication 
role:master 
connected_slaves:0 


# CPU 

used_cpu_sys:0.03 
used_cpu_user:0.01 
used_cpu_sys_children:0.00 
used_cpu_user_children:0.00 


# Keyspace 
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LASTSAVE 


LASTSAVE 

返回 最 近 一 次 Redis 成 功 将 数据 保存 到 磁盘 上 的 时 间 ， 以 UNIX 时 间 戳 格式 表示 。 
可 用 版 本 : 

>= 1.0.0 


时 间 复 杂 度 : 


一 个 UNIX at ja] Bh. 


redis> LASTSAVE 
(integer) 1324043588 


MONITOR 


MONITOR 


实时 打印 出 Redis 服务 器 接收 到 的 命令 ， 调 试用 。 


可 用 版 本 : 

>= 1.0.0 

A RAE : 
不 明确 

返回 值 : 

总 是 返回 ok 。 


127.0.0.1:6379> MONITOR 

OK 

# 以 第 一 个 打印 值 为 例 

# 1378822099 . 421623 2254 | 


# [9 127.0.0.1:56604] 中 的 9 是 数据 库 号 码 ， 127... Æ IP 地 址 和 端口 


# "PING" 是 被 执行 的 命令 

1378822099.421623 [0 127. 
1378822105.089572 [0 127. 
1378822109 .036925 [0 127. 
1378822140.649496 [0 127. 
1378822154.117160 [0 127. 
1378822257 .329412 [0 127. 
1378822258 .690131 [0 127. 


هو ه واه واه 
وه واه واه 
上 上 上 上 上‏ 


:56604] 
:56604] 
:56604] 
:56604] 
:56604] 
:56604] 
:56604] 


"PING" 

"SET" "msg" "hello world" 

"SET" "number" "123" 

"SADD" "fruits" "Apple" "Banana" "Cherry" 
"EXPIRE" "msg" "10086" 

"KEYS" "kN 

"DBSIZE" 


PSYNC 


PSYNC <MASTER_RUN_ID> <OFFSET> 
用 于 复制 功能 (replication) 的 内 部 命令 。 

更 多 信息 请 参考 复制 (Replication) 文档 。 
可 用 版 本 : 

>= 2.8.0 

时 间 复 杂 度 : 

不 明确 

返回 值 : 

不 明确 


127.0.0.1:6379> PSYNC ? -1 
"REDISQ006\xfe\xO0\xO0\xO2kKk\xO2vv\xOO\x03msg\xO5hello\xf f\xc3\x96P\x12h\bK\xef" 


SAVE 


SAVE 


SAVE 命令 执行 一 个 同步 保存 操作 ， 将 当前 Redis 实例 的 所 有 数据 快照 (snapshot) 以 RDB X 
件 的 形式 保存 到 硬盘 。 


一 般 来 说 ， 在 生产 环境 很 少 执行 SAVE 操作 ， 因 为 它 会 阻塞 所 有 客户 端 ， 保 存 数 据 库 的 任务 
通常 由 BGSAVE 命令 异步 地 执行 。 然 而 ， 如 果 负 责 保 存 数 据 的 后 台子 进程 不 幸 出 现 问题 时 ， 
SAVE 可 以 作为 保存 数据 的 最 后 手段 来 使 用 。 


请 参考 文档 : Redis 的 持久 化 运作 方式 (英文 ) 以 获取 更 多 消息 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复 杂 度 : 

O(N) n 为 要 保存 到 数据 库 中 的 key 的 数量 。 

返回 值 : 

保存 成 功 时 返回 ok 。 


redis> SAVE 
OK 


SHUTDOWN 


SHUTDOWN 
SHUTDOWN 命令 执行 以 下 操作 : 


。 停止 所 有 客户 端 

٠ 如 果 有 至 少 一 个 保存 点 在 等 待 ， 执 行 SAVE OB 
。 如 果 AOF 选项 被 打开 ， 更 新 AOF 文件 

٠ 关闭 redis 服务 器 (serven) 


如 果 持 久 化 被 打开 的 话 ， SHUTDOWN 命令 会 保证 服务 器 正常 关闭 而 不 去 失 任 何 数据。 


另 一 方面 ， 假 如 只 是 单纯 地 执行 SAVE 命令 ， 然 后 再 执行 QUT 命令 ， 则 没有 这 一 保证 
因为 在 执行 SAVE 之 后 、 执 行 QUIT 之 前 的 这 段 时 间 中 间 ， 其 他 客户 端 可 能 正在 和 服务 器 进 
行 通讯 ， 这 时 如 果 执 行 QUIT 就 会 造成 数据 丢失 。 





SAVE 和 NOSAVE 修饰 符 
通过 使 用 可 选 的 修饰 符 ， 可 以 修改 SHUTDOWN 命令 的 表现 。 比 如 说 : 


e 执行 SHUTDOWN SAVE 会 强制 让 数据 库 执行 保存 操作 ， 即 使 没有 设 定 (configure) 保 存 点 
e 执行 SHUTDOWN NOSAVE 会 阻止 数据 库 执 行 保存 操作 ， 即 使 已 经 设 定 有 一 个 或 多 个 保存 点 
(你 可 以 将 这 一 用 法 看 作 是 强制 停止 服务 器 的 一 个 假想 的 ABORT AA) 


可 用 版 本 : 

>= 1.0.0 

时 间 复 条 度 : 

不 明确 

返回 值 : 

执行 失败 时 返回 错误 。 执 行 成 功 时 不 返回 任何 信息 ， 服 务 器 和 客户 端的 连接 断 开 ， 客 户 端 自 
动 退出 。 


redis> PING 
PONG 

redis> SHUTDOWN 
$ 

$ redis 


Could not connect to Redis at: Connection refused 
not connected> 


SLAVEOF 


SLAVEOF host port 
SLAVEOF 命令 用 于 在 Redis 运行 时 动态 地 修改 复制 (replication) 功 能 的 行为 。 


通过 执行 SLAVEOF host port 命令 ， 可 以 将 当前 服务 器 转变 为 指定 服务 器 的 从 属 服务 器 (slave 
server). 


如 果 当 前 服务 器 已 经 是 某 个 主 服务 器 (master serven) 的 从 属 服务 器 ， 那 么 执行 
SLAVEOF host port 将 使 当前 服务 器 停止 对 旧 主 服务 器 的 同步 ， 丢 弃 旧 数据 集 ， 转 而 开始 对 新 
主 服 务 器 进行 同步 。 


另外 ， 对 一 个 从 属 服务 器 执行 命令 sLAvEOF No one 将 使 得 这 个 从 属 服务 器 关闭 复制 功能 ， 并 
从 从 属 服务 器 转变 回 主 服务 器 ， 原 来 同步 所 得 的 数据 集 不 会 被 丢弃 。 


利用 『 srLavEoF No one 不 会 丢弃 同步 所 得 数据 集 」 这 个 特性 ， 可 以 在 主 服务 器 失败 的 时 候 ， 
将 从 属 服务 器 用 作 新 的 主 服务 器 ， 从 而 实现 无 间断 运行 。 


可 用 版 本 : 
>= 1.0.0 
THERE: 
SLAVEOF host port , O(N), N 为 要 同步 的 数据 数量 。 sLAvEOoF no ONE , O(1) 。 
返回 值 : 
总 是 返回 ok 。 
redis> SLAVEOF 127.0.0.1 9 


redis> SLAVEOF NO ONE 


SLOWLOG 


SLOWLOG subcommand [argument] 
什么 是 SLOWLOG 
Slow log 是 Redis 用 来 记录 查询 执行 时 间 的 日 志 系 统 。 
查询 执行 时 间 指 的 是 不 包括 像 客户 端 响应 (talking)、 发 送 回复 等 IO 操作 ， 而 单单 是 执行 一 个 
查询 命 全 所 耗费 的 时 间 。 
另外 ，slow log 保存 在 内 存 里 面 ， 读 写 速 度 非常 快 ， 因 此 你 可 以 放心 地 使 用 它 ， 不 必 担 心 因为 
F é slow log 而 损害 Redis 的 速度 。 
设置 SLOWLOG 
Slow log 的 行为 由 两 个 配置 参数 (configuration parameter) 指 定 ， 可 以 通过 改写 redis.conf X 
件 或 者 用 conFIG GET 和 coNFIG SET 命令 对 它们 动态 地 进行 修改 。 
第 一 个 选项 是 slowlog-log-slower-than ， 它 决定 要 对 执行 时 间 大 于 多 少 微 秒 (microsecond， 
1 秒 = 1,000,000 微 秒 ) 的 查询 进行 记录 。 
比如 执行 以 下 命令 将 让 slow log 记录 所 有 查询 时 间 大 于 等 于 100 微 秒 的 查询 : 
CONFIG SET slowlog-log-slower-than 100 
而 以 下 命令 记录 所 有 查询 时 间 大 于 1000 微 秒 的 查询 : 
CONFIG SET slowlog-log-slower-than 0 
另 一 个 选项 是 slowlog-max-len ， 它 决定 slow log 最 多 能 保存 多 少 条 日 志 ， slow log 本 身 是 


一 个 FIFO 队列 ， 当 队列 大 小 超过 slowlog-max-len 时 ， 最 旧 的 一 条 日 志 将 被 删除 ， 而 最 新 
的 一 条 日 志 加 入 到 slow log ， 以 此 类 推 。 


以 下 命令 让 slow log 最 多 保存 1000 RAR : 


CONFIG SET slowlog-max-len 1000 


使 用 coNFIG GET 命令 可 以 查询 两 个 选项 的 当前 值 : 


redis> CONFIG GET slowlog-1log-slower-than 
1) "slowlog-1log-slower - than" 
2) "1000" 


redis> CONFIG GET slowlog-max-len 


1) "slowlog-max-len" 
2) "1000" 


查看 slow log 


要 查看 slow log ， 可 以 使 用 sLowLos cet 或 者 sLowLoG GET number 命令 ， 前 者 打印 所 有 
slow log , 最 大 长 度 取 决 于 slowlog-max-len 选项 的 值 ， 而 SLOWLOG GET number 则 只 打印 指 
定数 量 的 日 志 。 


最 新 的 日 志 会 最 先 被 打印 : 


# 为 测试 需要 ， 将 slowlog-log-slower-than 设 成 了 10 微 秒 


redis> SLOWLOG GET 


1) 1) (integer) 12 # 唯一 性 (unique) 的 日 志 标识 符 
2) (integer) 1324097834 # 被 记录 命令 的 执行 时 间 点 ， 以 UNIX 时 间 惟 格式 表示 
3) (integer) 16 # 查询 执行 时 间 ， 以 微 秒 为 单位 
4) 1) "CONFIG" # 执行 的 命 舍 ， 以 数组 的 形式 排列 
2) "GET" # 这 里 完整 的 命令 是 CONFIG GET slowlog-log-slower-the 


3) "slowlog-1log-slower -than" 


2) 1) (integer) 11 


2) (integer) 1324097825 
3) (integer) 42 
4) 1) "CONFIG" 
2) "GET" 
3) We 
3) 1) (integer) 10 
2) (integer) 1324097820 


) 

) 

3) (integer) 11 

) 1) "CONFIG" 

2) "GET" 

3) "slowlog-1log-slower-than" 





日 志 的 唯一 id 只 有 在 Redis 服务 器 重启 的 时 候 才 会 重 置 ， 这 祥 可 以 避免 对 日 志 的 重复 义理 ( 比 
如 你 可 能 会 想 在 每 次 发 现 新 的 慢 查询 时 发 邮件 通知 你 )。 


查看 当前 日 志 的 数量 
使 用 命令 sLowLo6 LEN 可 以 查看 当前 日 志 的 数量 。 


angle slower-max-len 的 区 别 ， 它 们 一 个 是 当前 日 志 的 数量 ， 一 个 是 允许 记录 的 最 
志 的 数量 。 


redis> SLOWLOG LEN 
(integer) 14 


清空 日 志 


使 用 命令 sLowLo6 RESET 可 以 清空 slow log 。 


redis> SLOWLOG LEN 
(integer) 14 


redis> SLOWLOG RESET 
OK 


redis> SLOWLOG LEN 
(integer) 0 


可 用 版 本 : 

>= 2.2.12 

时 间 复 杂 度 : 

O(1) 

返回 值 : 

取决 于 不 同 命令 ， 返 回 不 同 的 值 。 


SYNC 


SYNC 

用 于 复制 功能 (replication) 的 内 部 命令 。 

更 多 信息 请 参考 Redis 官网 的 Replication 章节 。 
可 用 版 本 : 

>= 1.0.0 

时 间 复杂 度 : 

不 明确 

返回 值 : 

不 明确 


redis> SYNC 
"REDISO002\xfe\x00\x00\auser_id\xcO\x03\x00\anumbers\xc2\xf3\xe0\x01\x00\x00\tdb_number\x 
(1.90s) 


SS 





TIME 


TIME 

返回 当前 服务 器 时 间 。 
可 用 版 本 : 

>= 2.6.0 


时 间 复 杂 度 : 


一 个 包含 两 个 字符 串 的 列表 : 第 一 个 字符 串 是 当前 时 间 ( 以 UNIX 时 间 戳 格式 表示 )， 而 第 二 个 
字符 串 是 当前 这 一 秒 钟 已 经 逝去 的 微 秒 数 。 


redis> TIME 
1) "1332395997" 
2) "952581" 
redis> TIME 
1) "1332395997" 
2) "953148" 


天 于 
本 文档 由 黄 健 宏 (huangz) 翻译 ， 版 权 为 Redis 官方 所 有 。 


更 新 日 志 (change log) 列 出 了 本 文档 的 主要 更 新 细节 ， 你 也 可 以 通过 关注 文档 的 github 项 目 
来 随时 追踪 文档 的 最 新 更 新 信息 。 


有 任何 问题 、 意 见 或 建议 ， 请 在 文档 配套 的 disqus 论坛 里 留言 ， 或 者 直接 联系 译 者 。 


Redis 书籍 推荐 


| 
设计 与 实现 


由 本 文档 译 者 黄 健 宏 创作 的 《Redis 设计 和 与 实现 》 一 书 正在 销售 中 ， 该 书 详细 地 介绍 了 
Redis 内 部 的 运作 原理 以 及 各 项 功能 的 实现 原理 ， 是 一 本 致力 于 帮助 Redis 使 用 者 加 深 对 
Redis 的 理解 ， 并 且 更 高 效 地 使 用 Redis 的 书籍 。 


欢迎 访问 RedisBook.com 并 了 解 《Redis 设计 和 与 实现 》 的 更 多 相关 信息 。 


iy Redis 


Redis 





由 《Redis 命 邻 参考 》 的 译 者 黄 健 宏 翻 译 的 《Redis 实 战 》 一 书 正在 火热 发 售 中 ， 该 书 深入 浅 
出 地 介绍 了 Redis 的 五 种 数据 结构 ， 并 通过 一 系列 实用 的 示例 深刻 地 展示 了 Redis 的 用 法 。 

此 外 ， 《Redis 实 战 》 还 介绍 了 多 种 扩展 和 优化 Redis 的 方法 ， 无 论 是 Redis 新 手 还 是 有 一 
定 经 验 的 Redis 使 用 者 ， 应 该 都 能 从 此 书 中 获 益 。 


欢迎 访问 redisinaction.com 并 了 解 《Redis 实 战 》 的 更 多 相关 信息 。 


参加 群 讨 论 


欢迎 各 位 《Redis 命 邻 参考 》 读 者 加 入 Redis 技术 讨论 QQ 群 398976550, 你 可 以 在 群 里 面 
SERA Redis 使 用 心得 ， 又 或 者 跟 其 他 人 讨论 你 在 使 用 Redis 过 程 中 遇 到 的 问题 。 


